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