dda-mcp-server

darkdragonsastro/dda-mcp-server

3.1

If you are the rightful owner of dda-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The DDA MCP Server is a Model Context Protocol server designed to control astronomy equipment, supporting both Dark Dragons Astronomy devices and ASCOM Alpaca-compatible equipment.

Tools
5
Resources
0
Prompts
0

DDA MCP Server

An MCP (Model Context Protocol) server for controlling astronomy equipment. Supports Dark Dragons Astronomy devices and any ASCOM Alpaca-compatible equipment.

Installation

npm install -g @darkdragonsastro/dda-mcp-server

Or run directly with npx:

npx @darkdragonsastro/dda-mcp-server

Configuration

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "dda": {
      "command": "npx",
      "args": ["@darkdragonsastro/dda-mcp-server"]
    }
  }
}

Claude Code

claude mcp add dda -- npx @darkdragonsastro/dda-mcp-server

Tools

Device Discovery

ToolDescription
discover_devicesDiscover Dark Dragons Astronomy devices on the local network via UDP broadcast
discover_alpaca_devicesDiscover ASCOM Alpaca devices on the local network

Dark Dragons Astronomy Devices

DragonLAIR (Roll-off Roof Controller)
ToolDescription
get_device_statusGet the current status of a device
get_device_settingsGet device settings including safety config, location, and motor settings
open_roofOpen the observatory roof
close_roofClose the observatory roof
abort_roofAbort the current roof operation
get_mount_sensorsGet status of mount sensors connected to a DragonLAIR
locate_deviceMake a device beep/flash to help locate it physically
Mount Sensor
ToolDescription
get_mount_sensor_statusGet status of a standalone Mount Sensor (pitch, roll, safe position)
DragonLIGHT (Flat Panel Controller)
ToolDescription
get_flat_panel_statusGet flat panel status (on/off, brightness)
turn_on_flat_panelTurn on the flat panel light
turn_off_flat_panelTurn off the flat panel light
set_flat_panel_brightnessSet brightness level (0-255)

ASCOM Alpaca Devices

All Alpaca devices must first be connected using alpaca_device_connect.

Connection Management
ToolDescription
alpaca_device_connectConnect or disconnect any Alpaca device
Telescope
ToolDescription
alpaca_telescope_statusGet telescope position, tracking state, and slewing status
alpaca_telescope_slewSlew to coordinates (RA/Dec or Alt/Az)
alpaca_telescope_parkPark or unpark the telescope
alpaca_telescope_trackingEnable or disable tracking
alpaca_telescope_abortAbort any slew in progress
Camera
ToolDescription
alpaca_camera_statusGet camera temperature, cooler state, and exposure status
alpaca_camera_coolerControl cooler on/off and set target temperature
alpaca_camera_exposeStart a light or dark exposure
alpaca_camera_abortAbort the current exposure
Focuser
ToolDescription
alpaca_focuser_statusGet focuser position, temperature, and movement state
alpaca_focuser_moveMove focuser to a specific position
alpaca_focuser_haltHalt focuser movement
Filter Wheel
ToolDescription
alpaca_filterwheel_statusGet current filter position and available filters
alpaca_filterwheel_setChange to a specific filter position
Dome
ToolDescription
alpaca_dome_statusGet dome shutter state, position, and slewing status
alpaca_dome_shutterOpen or close the dome shutter
alpaca_dome_slewSlew dome to a specific azimuth
Rotator
ToolDescription
alpaca_rotator_statusGet rotator position and movement state
alpaca_rotator_moveMove rotator to absolute or relative position
alpaca_rotator_haltHalt rotator movement
Switch
ToolDescription
alpaca_switch_statusGet status of all switches on a device
alpaca_switch_setSet a switch on or off
alpaca_switch_set_valueSet a switch to a specific value
Cover Calibrator
ToolDescription
alpaca_covercalibrator_statusGet cover and calibrator state
alpaca_covercalibrator_coverOpen, close, or halt the cover
alpaca_covercalibrator_calibratorTurn calibrator on (with brightness) or off
Safety Monitor
ToolDescription
alpaca_safetymonitor_statusGet safety monitor status (safe/unsafe)
Observing Conditions (Weather)
ToolDescription
alpaca_observingconditions_statusGet weather data (temperature, humidity, wind, cloud cover, etc.)

Supported Devices

Dark Dragons Astronomy

  • DragonLAIR - Roll-off roof controller with mount sensor integration
  • DragonLIGHT - Flat panel controller for calibration frames
  • Mount Sensor - Detects telescope position for safe roof operation

ASCOM Alpaca Compatible

Any device implementing the ASCOM Alpaca API:

  • Telescopes / Mounts
  • Cameras (CCD/CMOS)
  • Focusers
  • Filter Wheels
  • Domes
  • Rotators
  • Switches / Power Controllers
  • Cover Calibrators / Flat Panels
  • Safety Monitors
  • Weather Stations

License

ISC