stellarium-mcp 0.1.0

package/README.md

@@ -0,0 +1,110 @@
+# Stellarium MCP Server
+
+An MCP (Model Context Protocol) server that lets AI agents control [Stellarium](https://stellarium.org/) — the open-source planetarium software — via its Remote Control HTTP API.
+
+Built for astronomy workflows including telescope alignment, observation planning, and sky exploration. Especially useful in the southern hemisphere where Polaris is not available for polar alignment.
+
+## Prerequisites
+
+- **Node.js** 18+ installed
+- **Stellarium** installed with the **Remote Control** plugin enabled
+  - Open Stellarium → Press `F2` → Plugins → Remote Control
+  - Check "Load at startup"
+  - Click "configure" → Check "Server enabled" and "Enable automatically on startup"
+  - Default port: `8090`
+
+## Installation
+
+```bash
+cd stellarium-mcp
+npm install
+npm run build
+```
+
+## Usage with Claude Desktop
+
+Add this to your Claude Desktop configuration file:
+
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "stellarium": {
+      "command": "node",
+      "args": ["/FULL/PATH/TO/stellarium-mcp/build/index.js"],
+      "env": {
+        "STELLARIUM_HOST": "localhost",
+        "STELLARIUM_PORT": "8090"
+      }
+    }
+  }
+}
+```
+
+## Usage with Claude Code
+
+```bash
+claude mcp add stellarium node /FULL/PATH/TO/stellarium-mcp/build/index.js
+```
+
+## Environment Variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `STELLARIUM_HOST` | `localhost` | Stellarium Remote Control host |
+| `STELLARIUM_PORT` | `8090` | Stellarium Remote Control port |
+| `STELLARIUM_PASSWORD` | *(none)* | Password if authentication is enabled |
+
+## Available Tools
+
+### Core Tools
+
+| Tool | Description |
+|---|---|
+| `get_status` | Get current observer location, time, view direction, and FOV |
+| `search_object` | Search for celestial objects by name |
+| `get_object_info` | Get detailed info (coordinates, magnitude, rise/set times) |
+| `point_to_object` | Point the view/telescope to a named object |
+| `get_current_view` | Get current viewing direction in multiple coordinate systems |
+| `set_fov` | Set the field of view (zoom level) |
+
+### Alignment Helpers
+
+| Tool | Description |
+|---|---|
+| `suggest_alignment_stars` | Suggest optimal stars for telescope multi-star alignment |
+| `list_visible_objects` | List objects of a given type in the catalogue |
+| `list_object_types` | List all available object type categories |
+
+### Time & Location
+
+| Tool | Description |
+|---|---|
+| `set_time` | Set simulation time (Julian Day, UTC string, or time rate) |
+| `set_time_to_now` | Reset simulation to current real-world time |
+
+### Advanced
+
+| Tool | Description |
+|---|---|
+| `simbad_lookup` | Query the SIMBAD astronomical database |
+| `run_script` | Execute Stellarium Script commands directly |
+| `get_property` | Read a Stellarium internal property |
+| `set_property` | Write a Stellarium internal property |
+| `toggle_display_feature` | Toggle display features (grids, constellations, atmosphere, etc.) |
+
+## Example Conversations
+
+**"What bright stars can I use to align my telescope tonight?"**
+→ Agent uses `get_status` to check location/time, then `suggest_alignment_stars` to find the best 3 stars.
+
+**"Show me where the Southern Cross is"**
+→ Agent uses `search_object` for "Crux", then `point_to_object` to center the view.
+
+**"What planets are visible right now?"**
+→ Agent uses `list_visible_objects` with type "Planet", then `get_object_info` on each to check altitude.
+
+## License
+
+MIT

package/build/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Stellarium MCP Server
+ *
+ * An MCP server that provides AI agents with tools to control
+ * the Stellarium planetarium software via its Remote Control HTTP API.
+ *
+ * Designed for astronomy workflows including telescope alignment,
+ * observation planning, and sky exploration — especially useful
+ * in the southern hemisphere where Polaris is not available.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG"}

package/build/index.js

@@ -0,0 +1,466 @@
+#!/usr/bin/env node
+/**
+ * Stellarium MCP Server
+ *
+ * An MCP server that provides AI agents with tools to control
+ * the Stellarium planetarium software via its Remote Control HTTP API.
+ *
+ * Designed for astronomy workflows including telescope alignment,
+ * observation planning, and sky exploration — especially useful
+ * in the southern hemisphere where Polaris is not available.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { StellariumClient } from "./stellarium-client.js";
+// ─── Configuration ───────────────────────────────────────────────────
+const STELLARIUM_HOST = process.env.STELLARIUM_HOST ?? "localhost";
+const STELLARIUM_PORT = parseInt(process.env.STELLARIUM_PORT ?? "8090", 10);
+const STELLARIUM_PASSWORD = process.env.STELLARIUM_PASSWORD;
+const client = new StellariumClient({
+    host: STELLARIUM_HOST,
+    port: STELLARIUM_PORT,
+    password: STELLARIUM_PASSWORD,
+});
+// ─── Server Setup ────────────────────────────────────────────────────
+const server = new McpServer({
+    name: "stellarium-mcp",
+    version: "0.1.0",
+});
+// ─── Helper: format a tool response ─────────────────────────────────
+function textResult(data) {
+    const text = typeof data === "string" ? data : JSON.stringify(data, null, 2);
+    return { content: [{ type: "text", text }] };
+}
+function errorResult(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+}
+// ═══════════════════════════════════════════════════════════════════════
+//  CORE TOOLS
+// ═══════════════════════════════════════════════════════════════════════
+// ─── 1. get_status ───────────────────────────────────────────────────
+server.tool("get_status", "Get the current Stellarium status including observer location, simulation time, view direction, and field of view. Use this to understand the current state before performing other operations.", {}, async () => {
+    try {
+        const [status, view] = await Promise.all([client.getStatus(), client.getView()]);
+        return textResult({
+            location: status.location,
+            time: status.time,
+            view: {
+                fov_degrees: status.view.fov,
+                ...view,
+            },
+            selected_object: status.selectionInfo || "none",
+        });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ─── 2. search_object ────────────────────────────────────────────────
+server.tool("search_object", "Search for celestial objects by name. Returns a list of matching object names. Use this to find stars, planets, deep sky objects, constellations, etc.", {
+    query: z
+        .string()
+        .describe("The name or partial name to search for (e.g. 'Sirius', 'M42', 'Alpha Cen')"),
+}, async ({ query }) => {
+    try {
+        const results = await client.findObject(query);
+        return textResult({
+            query,
+            matches: results,
+            count: results.length,
+        });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ─── 3. get_object_info ──────────────────────────────────────────────
+server.tool("get_object_info", "Get detailed information about a specific celestial object including coordinates (RA/Dec, Alt/Az), magnitude, type, rise/set times, and more. The object must be an exact name (use search_object first if needed).", {
+    name: z
+        .string()
+        .describe("The exact name of the object (e.g. 'Sirius', 'Jupiter', 'M42')"),
+}, async ({ name }) => {
+    try {
+        const info = await client.getObjectInfo(name);
+        return textResult(info);
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ─── 4. point_to_object ─────────────────────────────────────────────
+server.tool("point_to_object", "Point the Stellarium view (and connected telescope, if any) to a named celestial object. The view will center on the object.", {
+    name: z
+        .string()
+        .describe("The exact name of the object to point to (e.g. 'Canopus', 'Saturn')"),
+}, async ({ name }) => {
+    try {
+        await client.focusObject(name);
+        // Give Stellarium a moment to slew, then get the object info
+        await new Promise((r) => setTimeout(r, 500));
+        const info = await client.getObjectInfo(name);
+        return textResult({
+            message: `Now pointing at ${name}`,
+            object_info: info,
+        });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ─── 5. get_current_view ─────────────────────────────────────────────
+server.tool("get_current_view", "Get the current viewing direction in multiple coordinate systems (J2000 equatorial, current epoch, and altitude/azimuth). Also returns the current field of view.", {}, async () => {
+    try {
+        const [status, view] = await Promise.all([client.getStatus(), client.getView()]);
+        return textResult({
+            fov_degrees: status.view.fov,
+            coordinates: view,
+        });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ─── 6. set_fov ──────────────────────────────────────────────────────
+server.tool("set_fov", "Set the field of view (zoom level) in degrees. Smaller values zoom in, larger values zoom out. Typical eyepiece view is 1-2 degrees, naked eye is about 60-120 degrees.", {
+    fov: z
+        .number()
+        .positive()
+        .describe("Field of view in degrees (e.g. 60 for wide view, 1 for telescopic view)"),
+}, async ({ fov }) => {
+    try {
+        await client.setFov(fov);
+        return textResult({ message: `Field of view set to ${fov}°` });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ═══════════════════════════════════════════════════════════════════════
+//  ALIGNMENT HELPER TOOLS
+// ═══════════════════════════════════════════════════════════════════════
+// ─── 7. suggest_alignment_stars ──────────────────────────────────────
+server.tool("suggest_alignment_stars", `Suggest the best stars for telescope multi-star alignment based on the current observer location and time. Returns bright stars that are currently above the horizon, well-spaced in azimuth, and suitable for alignment. Especially useful in the southern hemisphere where Polaris is not available.`, {
+    count: z
+        .number()
+        .int()
+        .min(1)
+        .max(10)
+        .default(3)
+        .describe("Number of alignment stars to suggest (default: 3)"),
+    min_altitude: z
+        .number()
+        .default(15)
+        .describe("Minimum altitude above horizon in degrees (default: 15)"),
+    max_magnitude: z
+        .number()
+        .default(2.0)
+        .describe("Maximum (faintest) apparent magnitude to consider (default: 2.0, brighter stars only)"),
+}, async ({ count, min_altitude, max_magnitude }) => {
+    try {
+        // Well-known bright stars used for alignment, covering all parts of the sky
+        const alignmentCandidates = [
+            "Sirius", "Canopus", "Rigil Kentaurus", "Arcturus", "Vega",
+            "Capella", "Rigel", "Procyon", "Achernar", "Betelgeuse",
+            "Hadar", "Acrux", "Altair", "Aldebaran", "Antares",
+            "Spica", "Pollux", "Fomalhaut", "Mimosa", "Deneb",
+            "Regulus", "Adhara", "Gacrux", "Shaula", "Bellatrix",
+            "Alnath", "Alnilam", "Alioth", "Dubhe", "Mirfak",
+            "Wezen", "Sargas", "Kaus Australis", "Avior", "Menkalinan",
+            "Atria", "Alhena", "Peacock", "Alsephina", "Mirzam",
+            "Alphard", "Polaris", "Hamal", "Algieba", "Diphda",
+            "Miaplacidus", "Ankaa", "Suhail", "Aspidiske", "Naos",
+        ];
+        // Query each candidate for current position
+        const starData = [];
+        for (const starName of alignmentCandidates) {
+            try {
+                const info = await client.getObjectInfo(starName);
+                if (!info || !info.found)
+                    continue;
+                const alt = info.altitude;
+                const az = info.azimuth;
+                const mag = info.vmag;
+                if (alt === undefined || az === undefined || mag === undefined)
+                    continue;
+                if (alt >= min_altitude && mag <= max_magnitude) {
+                    starData.push({
+                        name: starName,
+                        altitude: Math.round(alt * 100) / 100,
+                        azimuth: Math.round(((az + 360) % 360) * 100) / 100,
+                        magnitude: Math.round(mag * 100) / 100,
+                    });
+                }
+            }
+            catch {
+                // Star not found or error — skip
+                continue;
+            }
+        }
+        // Sort by magnitude (brightest first)
+        starData.sort((a, b) => a.magnitude - b.magnitude);
+        // Select well-spaced stars using a greedy algorithm
+        const selected = [];
+        const remaining = [...starData];
+        if (remaining.length > 0) {
+            // Start with the brightest star
+            selected.push(remaining.shift());
+            while (selected.length < count && remaining.length > 0) {
+                // Find the star that maximizes minimum angular separation from already selected stars
+                let bestIdx = 0;
+                let bestMinSep = -1;
+                for (let i = 0; i < remaining.length; i++) {
+                    let minSep = Infinity;
+                    for (const sel of selected) {
+                        // Angular separation approximation using azimuth difference
+                        const azDiff = Math.abs(remaining[i].azimuth - sel.azimuth);
+                        const sep = Math.min(azDiff, 360 - azDiff);
+                        minSep = Math.min(minSep, sep);
+                    }
+                    if (minSep > bestMinSep) {
+                        bestMinSep = minSep;
+                        bestIdx = i;
+                    }
+                }
+                selected.push(remaining.splice(bestIdx, 1)[0]);
+            }
+        }
+        return textResult({
+            suggested_alignment_stars: selected.map((s, i) => ({
+                order: i + 1,
+                name: s.name,
+                altitude_deg: s.altitude,
+                azimuth_deg: s.azimuth,
+                magnitude: s.magnitude,
+            })),
+            total_visible_bright_stars: starData.length,
+            criteria: {
+                min_altitude_deg: min_altitude,
+                max_magnitude: max_magnitude,
+                requested_count: count,
+            },
+            tip: "Stars are selected to be well-spaced in azimuth for best alignment accuracy. Point to each star in order using point_to_object.",
+        });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ─── 8. list_visible_objects ─────────────────────────────────────────
+server.tool("list_visible_objects", "List objects of a given type that are currently catalogued in Stellarium. Note: this returns all objects of that type in the catalogue, not just those above the horizon. Use get_object_info to check individual object positions.", {
+    type: z
+        .string()
+        .describe("Object type key (e.g. 'Star', 'Planet', 'Nebula', 'Galaxy', 'Constellation'). Use list_object_types to see all available types."),
+    english: z
+        .boolean()
+        .default(true)
+        .describe("Return names in English (default: true)"),
+}, async ({ type, english }) => {
+    try {
+        const objects = await client.listObjectsByType(type, { english });
+        return textResult({
+            type,
+            objects: objects.slice(0, 100), // Limit to prevent huge responses
+            total_count: objects.length,
+            note: objects.length > 100
+                ? "Showing first 100 results. Use search_object for specific targets."
+                : undefined,
+        });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ─── 9. list_object_types ────────────────────────────────────────────
+server.tool("list_object_types", "List all available celestial object type categories in Stellarium (e.g. Star, Planet, Nebula, Galaxy). Use these type keys with list_visible_objects.", {}, async () => {
+    try {
+        const types = await client.listObjectTypes();
+        return textResult(types);
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ═══════════════════════════════════════════════════════════════════════
+//  TIME & LOCATION TOOLS
+// ═══════════════════════════════════════════════════════════════════════
+// ─── 10. set_time ────────────────────────────────────────────────────
+server.tool("set_time", "Set the simulation time in Stellarium. You can set an absolute time (as Julian Day or ISO UTC string) and/or change the time rate. Use time rate 0 to pause, 1 for real-time, or larger values for fast-forward.", {
+    jday: z
+        .number()
+        .optional()
+        .describe("Julian Day number to set the time to"),
+    utc: z
+        .string()
+        .optional()
+        .describe("ISO 8601 UTC time string (e.g. '2026-04-06T03:00:00Z')"),
+    timerate: z
+        .number()
+        .optional()
+        .describe("Time rate in seconds per second (0 = paused, 1 = real-time, 3600 = 1 hour/sec)"),
+}, async ({ jday, utc, timerate }) => {
+    try {
+        await client.setTime({
+            time: jday,
+            utc: utc,
+            timerate: timerate,
+        });
+        // Get updated status
+        await new Promise((r) => setTimeout(r, 200));
+        const status = await client.getStatus();
+        return textResult({
+            message: "Time updated",
+            current_time: status.time,
+        });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ─── 11. set_time_to_now ─────────────────────────────────────────────
+server.tool("set_time_to_now", "Reset the simulation time to the current real-world time. Useful after fast-forwarding or rewinding.", {}, async () => {
+    try {
+        // Setting timerate to 1 and using the action to sync to now
+        await client.doAction("actionSet_TimeRate_0");
+        await new Promise((r) => setTimeout(r, 100));
+        await client.doAction("actionReturn_To_Current_Time");
+        await new Promise((r) => setTimeout(r, 200));
+        const status = await client.getStatus();
+        return textResult({
+            message: "Time reset to now",
+            current_time: status.time,
+        });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ═══════════════════════════════════════════════════════════════════════
+//  ADVANCED TOOLS
+// ═══════════════════════════════════════════════════════════════════════
+// ─── 12. simbad_lookup ───────────────────────────────────────────────
+server.tool("simbad_lookup", "Look up an object in the SIMBAD astronomical database. Returns professional astronomical data about the object.", {
+    name: z
+        .string()
+        .describe("Object name or designation to look up in SIMBAD"),
+}, async ({ name }) => {
+    try {
+        const result = await client.simbadLookup(name);
+        return textResult(result);
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ─── 13. run_script ──────────────────────────────────────────────────
+server.tool("run_script", "Execute a Stellarium script command directly. This gives low-level access to Stellarium's scripting engine for advanced operations. See Stellarium scripting documentation for available commands.", {
+    code: z
+        .string()
+        .describe("Stellarium Script code to execute (e.g. 'core.setObserverLocation(-19.73, -42.63, 300, 0, \"My Location\", \"Earth\")')"),
+}, async ({ code }) => {
+    try {
+        const result = await client.directScript(code);
+        return textResult({
+            message: "Script executed",
+            result: result || "ok",
+        });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ─── 14. get_property ────────────────────────────────────────────────
+server.tool("get_property", "Get the value of a Stellarium internal property. Properties control many aspects of Stellarium's behavior and display.", {
+    id: z
+        .string()
+        .describe("Property ID (e.g. 'StelMovementMgr.currentFov', 'StelSkyDrawer.limitMagnitude')"),
+}, async ({ id }) => {
+    try {
+        const result = await client.getProperty(id);
+        return textResult(result);
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ─── 15. set_property ────────────────────────────────────────────────
+server.tool("set_property", "Set a Stellarium internal property value. Use with caution — this can change any aspect of Stellarium's behavior.", {
+    id: z
+        .string()
+        .describe("Property ID to set"),
+    value: z
+        .string()
+        .describe("New value for the property (as string)"),
+}, async ({ id, value }) => {
+    try {
+        await client.setProperty(id, value);
+        return textResult({ message: `Property ${id} set to ${value}` });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ─── 16. toggle_display_feature ──────────────────────────────────────
+server.tool("toggle_display_feature", "Toggle Stellarium display features on/off. Common features: constellation_lines, constellation_labels, constellation_art, atmosphere, ground, cardinal_points, equatorial_grid, azimuthal_grid, stars, planets, nebulae, milky_way.", {
+    feature: z
+        .enum([
+        "constellation_lines",
+        "constellation_labels",
+        "constellation_art",
+        "atmosphere",
+        "ground",
+        "cardinal_points",
+        "equatorial_grid",
+        "azimuthal_grid",
+        "stars",
+        "planets",
+        "nebulae",
+        "milky_way",
+    ])
+        .describe("The display feature to toggle"),
+}, async ({ feature }) => {
+    try {
+        const actionMap = {
+            constellation_lines: "actionShow_Constellation_Lines",
+            constellation_labels: "actionShow_Constellation_Labels",
+            constellation_art: "actionShow_Constellation_Art",
+            atmosphere: "actionShow_Atmosphere",
+            ground: "actionShow_Ground",
+            cardinal_points: "actionShow_Cardinal_Points",
+            equatorial_grid: "actionShow_Equatorial_Grid",
+            azimuthal_grid: "actionShow_Azimuthal_Grid",
+            stars: "actionShow_Stars",
+            planets: "actionShow_Planets",
+            nebulae: "actionShow_Nebulae",
+            milky_way: "actionShow_MilkyWay",
+        };
+        const actionId = actionMap[feature];
+        if (!actionId) {
+            return errorResult(`Unknown feature: ${feature}`);
+        }
+        const result = await client.doAction(actionId);
+        return textResult({
+            message: `Toggled ${feature}`,
+            result,
+        });
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+});
+// ═══════════════════════════════════════════════════════════════════════
+//  START SERVER
+// ═══════════════════════════════════════════════════════════════════════
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr (not stdout — stdout is reserved for MCP JSON-RPC)
+    console.error("Stellarium MCP server running on stdio");
+    console.error(`Connecting to Stellarium at ${STELLARIUM_HOST}:${STELLARIUM_PORT}`);
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/stellarium-client.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Stellarium Remote Control HTTP Client
+ *
+ * Wraps the Stellarium Remote Control plugin API (default: http://localhost:8090).
+ * See: https://stellarium.org/doc/23.0/remoteControlApi.html
+ *
+ * Uses Node's http module instead of fetch because Stellarium's built-in HTTP
+ * server does not support chunked Transfer-Encoding, which Node's undici-based
+ * fetch sends for POST requests.
+ */
+export interface StellariumClientOptions {
+    host?: string;
+    port?: number;
+    password?: string;
+}
+export interface StellariumStatus {
+    location: {
+        name: string;
+        latitude: number;
+        longitude: number;
+        altitude: number;
+        planet: string;
+    };
+    time: {
+        jDay: number;
+        utc: string;
+        local: string;
+        deltaT: number;
+        gmtShift: number;
+        timeRate: number;
+        isTimeNow: boolean;
+    };
+    view: {
+        fov: number;
+        j2000: [number, number, number];
+        jNow: [number, number, number];
+        altAz: [number, number, number];
+    };
+    selectionInfo: string;
+    actionChanges: Record<string, boolean>;
+    propertyChanges: Record<string, unknown>;
+}
+export interface ObjectInfo {
+    found: boolean;
+    name: string;
+    "localized-name": string;
+    type: string;
+    "star-type"?: string;
+    ra: number;
+    dec: number;
+    raJ2000: number;
+    decJ2000: number;
+    altitude: number;
+    azimuth: number;
+    vmag: number;
+    "absolute-mag"?: number;
+    "distance-ly"?: number;
+    rise?: string;
+    "rise-dhr"?: number;
+    transit?: string;
+    "transit-dhr"?: number;
+    set?: string;
+    "set-dhr"?: number;
+    "above-horizon": boolean;
+    iauConstellation: string;
+    "size-deg"?: string;
+    "spectral-class"?: string;
+    [key: string]: unknown;
+}
+export declare class StellariumClient {
+    private host;
+    private port;
+    private authHeader?;
+    constructor(options?: StellariumClientOptions);
+    private request;
+    private get;
+    private post;
+    /** Get the full Stellarium status (location, time, view direction, etc.) */
+    getStatus(): Promise<StellariumStatus>;
+    /** Get the current view direction */
+    getView(): Promise<{
+        j2000: number[];
+        jNow: number[];
+        altAz: number[];
+    }>;
+    /** Set the view direction using a coordinate vector */
+    setView(coords: [number, number, number], coordSystem?: "j2000" | "jNow" | "altAz"): Promise<string>;
+    /** Set the field of view in degrees */
+    setFov(fovDegrees: number): Promise<string>;
+    /** Focus on an object by name */
+    focusObject(objectName: string): Promise<string>;
+    /** Move the view (simulates arrow key presses) */
+    moveView(x: number, y: number): Promise<string>;
+    /** Convert a Date or ISO string to Julian Day number */
+    private utcToJulianDay;
+    /** Set the simulation time */
+    setTime(params: {
+        time?: number;
+        timerate?: number;
+        utc?: string;
+    }): Promise<string>;
+    /** Search for objects by name (returns a list of matching names) */
+    findObject(name: string): Promise<string[]>;
+    /** Get detailed information about a specific object */
+    getObjectInfo(name: string): Promise<ObjectInfo>;
+    /** List all available object types */
+    listObjectTypes(): Promise<Array<{
+        key: string;
+        name: string;
+    }>>;
+    /** List objects of a specific type */
+    listObjectsByType(type: string, options?: {
+        english?: boolean;
+    }): Promise<string[]>;
+    /** List available locations */
+    listLocations(): Promise<string[]>;
+    /** List countries */
+    listCountries(): Promise<string[]>;
+    /** Look up an object in the SIMBAD astronomical database */
+    simbadLookup(name: string): Promise<unknown>;
+    /** Trigger or toggle a Stellarium action by ID */
+    doAction(actionId: string): Promise<unknown>;
+    /** Get the value of a Stellarium property */
+    getProperty(propId: string): Promise<unknown>;
+    /** Set a Stellarium property value */
+    setProperty(propId: string, value: string): Promise<string>;
+    /** List available scripts */
+    listScripts(): Promise<unknown>;
+    /** Run a script by filename */
+    runScript(scriptId: string): Promise<string>;
+    /** Execute Stellarium Script code directly */
+    directScript(code: string): Promise<string>;
+    /** Get script execution status */
+    getScriptStatus(): Promise<unknown>;
+    /** Stop the currently running script */
+    stopScript(): Promise<string>;
+    /** Check if the Stellarium API is reachable */
+    ping(): Promise<boolean>;
+}
+//# sourceMappingURL=stellarium-client.d.ts.map

package/build/stellarium-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stellarium-client.d.ts","sourceRoot":"","sources":["../src/stellarium-client.ts"],"names":[],"mappings":"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"}

package/build/stellarium-client.js

@@ -0,0 +1,246 @@
+/**
+ * Stellarium Remote Control HTTP Client
+ *
+ * Wraps the Stellarium Remote Control plugin API (default: http://localhost:8090).
+ * See: https://stellarium.org/doc/23.0/remoteControlApi.html
+ *
+ * Uses Node's http module instead of fetch because Stellarium's built-in HTTP
+ * server does not support chunked Transfer-Encoding, which Node's undici-based
+ * fetch sends for POST requests.
+ */
+import * as http from "node:http";
+export class StellariumClient {
+    host;
+    port;
+    authHeader;
+    constructor(options = {}) {
+        this.host = options.host ?? "localhost";
+        this.port = options.port ?? 8090;
+        if (options.password) {
+            const encoded = Buffer.from(`:${options.password}`).toString("base64");
+            this.authHeader = `Basic ${encoded}`;
+        }
+    }
+    // ─── Low-level HTTP helpers ────────────────────────────────────────
+    request(method, path, body) {
+        return new Promise((resolve, reject) => {
+            const headers = {};
+            if (body !== undefined) {
+                headers["Content-Type"] = "application/x-www-form-urlencoded";
+                headers["Content-Length"] = Buffer.byteLength(body).toString();
+            }
+            if (this.authHeader) {
+                headers["Authorization"] = this.authHeader;
+            }
+            const req = http.request({ hostname: this.host, port: this.port, path, method, headers }, (res) => {
+                let data = "";
+                res.on("data", (chunk) => (data += chunk));
+                res.on("end", () => resolve({ status: res.statusCode ?? 0, data }));
+            });
+            req.on("error", reject);
+            if (body !== undefined)
+                req.write(body);
+            req.end();
+        });
+    }
+    async get(path, params) {
+        const url = new URL(path, `http://${this.host}:${this.port}`);
+        if (params) {
+            for (const [k, v] of Object.entries(params)) {
+                url.searchParams.set(k, v);
+            }
+        }
+        const { status, data } = await this.request("GET", url.pathname + url.search);
+        if (status < 200 || status >= 300) {
+            throw new Error(`Stellarium API error ${status}: ${data}`);
+        }
+        try {
+            return JSON.parse(data);
+        }
+        catch {
+            return data;
+        }
+    }
+    async post(path, body) {
+        const encoded = body ? new URLSearchParams(body).toString() : undefined;
+        const { status, data } = await this.request("POST", path, encoded);
+        if (status < 200 || status >= 300) {
+            throw new Error(`Stellarium API error ${status}: ${data}`);
+        }
+        try {
+            return JSON.parse(data);
+        }
+        catch {
+            return data;
+        }
+    }
+    // ─── Main Service ──────────────────────────────────────────────────
+    /** Get the full Stellarium status (location, time, view direction, etc.) */
+    async getStatus() {
+        return (await this.get("/api/main/status"));
+    }
+    /** Get the current view direction */
+    async getView() {
+        return (await this.get("/api/main/view"));
+    }
+    /** Set the view direction using a coordinate vector */
+    async setView(coords, coordSystem = "j2000") {
+        return (await this.post("/api/main/view", {
+            [coordSystem]: JSON.stringify(coords),
+        }));
+    }
+    /** Set the field of view in degrees */
+    async setFov(fovDegrees) {
+        return (await this.post("/api/main/fov", {
+            fov: fovDegrees.toString(),
+        }));
+    }
+    /** Focus on an object by name */
+    async focusObject(objectName) {
+        return (await this.post("/api/main/focus", {
+            target: objectName,
+        }));
+    }
+    /** Move the view (simulates arrow key presses) */
+    async moveView(x, y) {
+        return (await this.post("/api/main/move", {
+            x: x.toString(),
+            y: y.toString(),
+        }));
+    }
+    /** Convert a Date or ISO string to Julian Day number */
+    utcToJulianDay(utc) {
+        const d = typeof utc === "string" ? new Date(utc) : utc;
+        return d.getTime() / 86400000 + 2440587.5;
+    }
+    /** Set the simulation time */
+    async setTime(params) {
+        const body = {};
+        if (params.utc !== undefined) {
+            body["time"] = this.utcToJulianDay(params.utc).toString();
+        }
+        else if (params.time !== undefined) {
+            body["time"] = params.time.toString();
+        }
+        if (params.timerate !== undefined)
+            body["timerate"] = params.timerate.toString();
+        return (await this.post("/api/main/time", body));
+    }
+    // ─── Object Service ────────────────────────────────────────────────
+    /** Search for objects by name (returns a list of matching names) */
+    async findObject(name) {
+        const result = await this.get("/api/objects/find", { str: name });
+        // The API returns a newline-separated list or JSON array
+        if (typeof result === "string") {
+            return result
+                .split("\n")
+                .map((s) => s.trim())
+                .filter(Boolean);
+        }
+        return result;
+    }
+    /** Get detailed information about a specific object */
+    async getObjectInfo(name) {
+        return (await this.get("/api/objects/info", { name, format: "json" }));
+    }
+    /** List all available object types */
+    async listObjectTypes() {
+        return (await this.get("/api/objects/listobjecttypes"));
+    }
+    /** List objects of a specific type */
+    async listObjectsByType(type, options) {
+        const params = { type };
+        if (options?.english)
+            params["english"] = "true";
+        const result = await this.get("/api/objects/listobjectsbytype", params);
+        if (typeof result === "string") {
+            return result
+                .split("\n")
+                .map((s) => s.trim())
+                .filter(Boolean);
+        }
+        return result;
+    }
+    // ─── Location Service ──────────────────────────────────────────────
+    /** List available locations */
+    async listLocations() {
+        const result = await this.get("/api/location/list");
+        if (typeof result === "string") {
+            return result
+                .split("\n")
+                .map((s) => s.trim())
+                .filter(Boolean);
+        }
+        return result;
+    }
+    /** List countries */
+    async listCountries() {
+        const result = await this.get("/api/location/countrylist");
+        if (typeof result === "string") {
+            return result
+                .split("\n")
+                .map((s) => s.trim())
+                .filter(Boolean);
+        }
+        return result;
+    }
+    // ─── SIMBAD Service ────────────────────────────────────────────────
+    /** Look up an object in the SIMBAD astronomical database */
+    async simbadLookup(name) {
+        return this.get("/api/simbad/lookup", { str: name });
+    }
+    // ─── StelAction Service ────────────────────────────────────────────
+    /** Trigger or toggle a Stellarium action by ID */
+    async doAction(actionId) {
+        return this.post("/api/stelaction/do", { id: actionId });
+    }
+    // ─── StelProperty Service ──────────────────────────────────────────
+    /** Get the value of a Stellarium property */
+    async getProperty(propId) {
+        const all = (await this.get("/api/stelproperty/list"));
+        if (propId in all) {
+            return { [propId]: all[propId] };
+        }
+        throw new Error(`Property not found: ${propId}`);
+    }
+    /** Set a Stellarium property value */
+    async setProperty(propId, value) {
+        return (await this.post("/api/stelproperty/set", {
+            id: propId,
+            value,
+        }));
+    }
+    // ─── Script Service ────────────────────────────────────────────────
+    /** List available scripts */
+    async listScripts() {
+        return this.get("/api/scripts/list");
+    }
+    /** Run a script by filename */
+    async runScript(scriptId) {
+        return (await this.post("/api/scripts/run", { id: scriptId }));
+    }
+    /** Execute Stellarium Script code directly */
+    async directScript(code) {
+        return (await this.post("/api/scripts/direct", { code }));
+    }
+    /** Get script execution status */
+    async getScriptStatus() {
+        return this.get("/api/scripts/status");
+    }
+    /** Stop the currently running script */
+    async stopScript() {
+        return (await this.post("/api/scripts/stop"));
+    }
+    // ─── Utility / Health ──────────────────────────────────────────────
+    /** Check if the Stellarium API is reachable */
+    async ping() {
+        try {
+            await this.getStatus();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=stellarium-client.js.map

package/build/stellarium-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stellarium-client.js","sourceRoot":"","sources":["../src/stellarium-client.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "stellarium-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for controlling Stellarium planetarium software",
+  "type": "module",
+  "bin": {
+    "stellarium-mcp": "build/index.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x build/index.js",
+    "dev": "tsc --watch",
+    "start": "node build/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "files": [
+    "build"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.2"
+  },
+  "keywords": [
+    "mcp",
+    "stellarium",
+    "astronomy",
+    "telescope",
+    "planetarium"
+  ],
+  "license": "MIT"
+}