1. Conduid
  2. Developer Tools
  3. Ascom
MCP server · Developer Tools

Ascom

by · github.com/stellarpunk/mcp-server-ascom

Control ASCOM-compatible telescopes through AI assistants. Where brass meets binary, steam meets stars.

Unclaimed MIT last commit a year ago devtools
InstallView source
49Fair

Scored yesterday · breakdown

About Ascom

Ascom is an MCP server published by stellarpunk in the Developer Tools category: control ASCOM-compatible telescopes through AI assistants. Where brass meets binary, steam meets stars. It has been installed 0 times through Conduid.

Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.

Install

Install
npx mcp-server-ascom

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Ascom

Powered by Claude · Grounded in docs

I know everything about Ascom. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ·README presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

Releases

v0.2.1v0.2.1 · 30 Jul 2025Full Changelog**: https://github.com/stellarpunk/mcp-server-ascom/compare/v0.2.0...v0.2.1

README

MCP Server for ASCOM

MCP Python PyPI Tests License

Control telescopes with AI. Works with any ASCOM device.

Documentation

v0.3.0 Updates

  • FastMCP 2.0 - Half the code
  • JSON logging - OpenTelemetry ready
  • Better errors - Protocol compliance built-in

Features

  • Works with any ASCOM telescope, camera, or focuser
  • Natural language control: "Point at the Orion Nebula"
  • Auto-discovers devices on your network
  • Async architecture - never blocks
  • Full test coverage and type safety

Installation

# Quick start
pip install mcp-server-ascom

# Or use uvx (no install)
uvx mcp-server-ascom

🚀 v0.4.0: Instant Connections!

No more waiting! Connect directly without discovery:

# Direct connection - no setup required!
telescope_connect device_id="seestar@192.168.1.100:5555"

Claude Desktop Setup

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ascom": {
      "command": "uvx",
      "args": ["mcp-server-ascom"],
      "env": {
        "ASCOM_DIRECT_DEVICES": "telescope_1:localhost:5555:Seestar S50"
      }
    }
  }
}

Restart Claude Desktop to activate.

Usage

Quick Connect (No Configuration)

You: Connect to seestar@192.168.1.100:5555
AI: Connected to Seestar S50!

You: Point at the Orion Nebula  
AI: Slewing to M42... Done.

With Pre-Configured Devices

You: Connect to telescope_1
AI: Connected to Seestar S50!

Supported Equipment

Any ASCOM Alpaca device: telescopes, cameras, focusers, filter wheels, domes.

Available Tools

  • discover_ascom_devices - Find devices on network
  • telescope_connect / camera_connect - Connect to device
  • telescope_goto / telescope_goto_object - Point telescope
  • telescope_park - Park at home position
  • camera_capture - Take images

Event Streaming 🆕

Real-time event streaming from ASCOM devices (especially Seestar S50):

  • Event History: get_event_history - Retrieve past events with filtering
  • Event Types: get_event_types - List available event types
  • Event Stream: ascom://events/{device_id}/stream - Live event feed
  • Clear History: clear_event_history - Clear event buffer

Supported event types:

  • PiStatus - System status (battery, temperature)
  • GotoComplete - Movement completed
  • BalanceSensor - Device orientation
  • ViewChanged - View state changes
  • And more...

Development

git clone https://github.com/stellarpunk/mcp-server-ascom.git
cd mcp-server-ascom
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"

# Development with hot-reload
invoke dev --hot  # Auto-restarts on code changes

# Run tests
pytest

Hot-reload uses watchmedo to monitor Python files and restart automatically. See Development Guide for details.

Security

Local connections only by default. For remote access, enable OAuth in .env.

Troubleshooting

No devices found?

  • Check device is powered on and on same network
  • Allow UDP port 32227 through firewall
  • Test with: curl http://device-ip:11111/api/v1/description

Import errors? The alpyca package imports as alpaca.

See troubleshooting.md for more.

Documentation

License

MIT

README mirrored from the source repository yesterday. The original is authoritative.

Questions

About Ascom

How do I install Ascom?

Run npx mcp-server-ascom, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is Ascom safe to use with an AI agent?

Its trust score is 49 out of 100 (fair). It passes 0 of 1 static security checks; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Ascom still maintained?

The last commit was a year ago, with 0 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.