indigo-mcp

MCP (Model Context Protocol) server for INDIGO astronomy automation protocol.

Lets AI agents (Claude, Hermes, etc.) control telescopes, cameras, focusers, filter wheels, domes, and other astronomical equipment through the INDIGO protocol.

Architecture

AI Agent ←→ MCP Protocol ←→ indigo-mcp ←→ INDIGO Server (port 7624) ←→ Hardware

Quick Start

# Install
pip install -e ".[dev]"

# Run (connects to INDIGO at localhost:7624)
indigo-mcp

# Or specify host/port
indigo-mcp --host 192.168.1.100 --port 7624

Configuration

Environment variables:

• INDIGO_HOST — INDIGO server host (default: localhost)
• INDIGO_PORT — INDIGO server port (default: 7624)
• INDIGO_WS — Use WebSocket transport instead of raw TCP (default: false)

Or pass as CLI arguments:

indigo-mcp --host 192.168.1.100 --port 7624 --ws

MCP Tools

Tool	Description
indigo_list_devices	List all connected devices and their interfaces
indigo_get_property	Get current value of a device property
indigo_set_property	Set a device property value
indigo_connect_device	Connect to a device
indigo_disconnect_device	Disconnect from a device
indigo_capture_image	Take an exposure with a CCD
indigo_abort_exposure	Abort an ongoing exposure
indigo_slew	Slew telescope to RA/Dec coordinates
indigo_park	Park the telescope
indigo_get_coordinates	Get current telescope coordinates
indigo_set_tracking	Enable/disable mount tracking
indigo_move_focuser	Move focuser by relative steps
indigo_set_filter	Set filter wheel slot
indigo_script_upload	Upload & persist a JavaScript script to the Scripting Agent
indigo_script_list	List scripts stored on the Scripting Agent
indigo_script_execute	Execute a stored script by name (waits for Busy→Ok/Alert)
indigo_script_run	Run an inline JS snippet (e.g. launch a Sequencer.js sequence)
indigo_script_delete	Delete a stored script
indigo_script_monitor	Monitor script execution: state changes, log messages, watched properties

Project Structure

indigo-mcp/
├── pyproject.toml
├── README.md
├── src/
│   └── indigo_mcp/
│       ├── __init__.py
│       ├── server.py      # MCP server entry point
│       ├── client.py      # INDIGO TCP/WS client
│       ├── protocol.py    # JSON message serialization/deserialization
│       └── tools.py       # MCP tool implementations
└── tests/
    └── __init__.py