@interstellar-tools/mcp 0.0.0-stage → 0.0.0

package/README.md

@@ -1,3 +1,109 @@
-# Temporary Holding Version
+# @interstellar-tools/mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that
+gives AI assistants deterministic, unit-explicit orbital mechanics calculations
+and celestial body datasets, backed by `@interstellar-tools/equations`,
+`@interstellar-tools/constants` and `@interstellar-tools/temporal`.
+
+## Documentation
+
+The full documentation lives at
+**[phun-ky.net/interstellar-tools](https://phun-ky.net/interstellar-tools/)**:
+
+- [Using the MCP server](https://phun-ky.net/interstellar-tools/guide/mcp/):
+  step-by-step setup for Claude, ChatGPT, Mistral Le Chat, Gemini, GitHub
+  Copilot, Cursor, JetBrains and more
+- [API reference for `@interstellar-tools/mcp`](https://phun-ky.net/interstellar-tools/api/@interstellar-tools/mcp/)
+- [API reference for the equations](https://phun-ky.net/interstellar-tools/api/@interstellar-tools/equations/)
+  that every tool wraps
+
+## Installation
+
+- [Node.js](https://nodejs.org/) version 22.9.0 or higher
+
+Add it to any MCP client that launches stdio servers, for example:
+
+```json
+{
+  "mcpServers": {
+    "interstellar-tools": {
+      "command": "npx",
+      "args": ["-y", "@interstellar-tools/mcp"]
+    }
+  }
+}
+```
+
+Or with Claude Code:
+
+```shell
+claude mcp add interstellar-tools -- npx -y @interstellar-tools/mcp
+```
+
+### Remote (HTTP)
+
+Web assistants such as claude.ai, ChatGPT and Mistral Le Chat connect to remote
+servers only. Serve Streamable HTTP and put it behind HTTPS (a tunnel such as
+`cloudflared tunnel --url http://localhost:3000` is enough for testing):
+
+```shell
+npx -y @interstellar-tools/mcp --http --port 3000
+# → http://127.0.0.1:3000/mcp
+```
+
+The server is stateless and binds to `127.0.0.1` unless you pass
+`--host 0.0.0.0`. Step-by-step setup for each assistant is in the
+[MCP guide](https://phun-ky.net/interstellar-tools/guide/mcp/).
+
+## Units
+
+Every input and output field name ends with its unit: `r_m` (metres), `m0_kg`
+(kilograms), `v_m_s` (m/s), `mu_m3_s2` (m³/s²), `T_s` / `T_d` (seconds / days).
+Angles are passed as `{ "value": 28.5, "unit": "deg" }` (or `"rad"`) and
+returned as `{ "rad": …, "deg": … }`.
+
+## Tools
+
+| Tool                         | What it computes                                     |
+| ---------------------------- | ---------------------------------------------------- |
+| `gravitational_parameter`    | μ = G·(M + m) from masses                            |
+| `circular_speed`             | Circular orbit speed at radius r                     |
+| `escape_speed`               | Escape speed at radius r                             |
+| `vis_viva_speed`             | Speed at radius r on an orbit with semi-major axis a |
+| `kepler_period`              | Orbital period from semi-major axis                  |
+| `peri_apoapsis_radii`        | Periapsis and apoapsis radii from a and e            |
+| `sphere_of_influence_radius` | Laplace sphere of influence                          |
+| `hohmann_transfer`           | Both burns, total Δv and transfer time               |
+| `rocket_delta_v`             | Tsiolkovsky rocket equation from Isp and masses      |
+| `plane_change_delta_v`       | Δv for a pure inclination change                     |
+| `solve_kepler`               | Eccentric anomaly from mean anomaly and eccentricity |
+| `convert_anomaly`            | Mean ↔ eccentric ↔ true anomaly (elliptic orbits)    |
+| `convert_time`               | Duration between units, attoseconds to gigayears     |
+| `find_body`                  | Look up planets, moons, stars, comets, … by name     |
+
+All tools are pure and offline: no network access, no side effects.
+
+## Resources
+
+Each dataset in `@interstellar-tools/constants` is available as a JSON resource
+at `interstellar://datasets/{name}`, where `name` is one of `planets`, `moons`,
+`stars`, `comets`, `asteroids`, `asteroid-belts`, `galaxies` or `systems`.
+
+> [!NOTE]
+>
+> The Alpha Centauri entries are left out of `stars` until their orbital model
+> is corrected.
+
+## Programmatic use
+
+```ts
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+
+import { createServer, startHttpServer } from '@interstellar-tools/mcp';
+
+// stdio
+await createServer().connect(new StdioServerTransport());
+
+// or Streamable HTTP on http://127.0.0.1:3000/mcp
+await startHttpServer({ port: 3000 });
+```

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

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

package/dist/bin.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import process from 'node:process';
+import { parseArgs } from 'node:util';
+import { startHttpServer } from './http.js';
+import { createServer } from './server.js';
+const { values } = parseArgs({
+    options: {
+        http: { type: 'boolean', default: false },
+        port: { type: 'string', default: process.env.PORT ?? '3000' },
+        host: { type: 'string', default: '127.0.0.1' },
+        help: { type: 'boolean', short: 'h', default: false }
+    }
+});
+if (values.help) {
+    process.stdout
+        .write(`Usage: interstellar-tools-mcp [--http] [--port <n>] [--host <addr>]
+
+  (default)       Serve over stdio, for clients that launch the server themselves
+  --http          Serve Streamable HTTP at http://<host>:<port>/mcp
+  --port <n>      HTTP port (default: $PORT or 3000)
+  --host <addr>   HTTP bind address (default: 127.0.0.1)
+`);
+}
+else if (values.http) {
+    const http = await startHttpServer({
+        port: Number(values.port),
+        host: values.host
+    });
+    const { address, port } = http.address();
+    // stdout stays clean for stdio clients; logs go to stderr
+    process.stderr.write(`interstellar-tools MCP server listening on http://${address}:${port}/mcp\n`);
+}
+else {
+    await createServer().connect(new StdioServerTransport());
+}
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAGjF,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE;QACP,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;QACzC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE;QAC7D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE;QAC9C,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;KACtD;CACF,CAAC,CAAC;AAEH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IAChB,OAAO,CAAC,MAAM;SACX,KAAK,CAAC;;;;;;CAMV,CAAC,CAAC;AACH,CAAC;KAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC;QACjC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC,CAAC;IACH,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,EAAiB,CAAC;IAExD,0DAA0D;IAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qDAAqD,OAAO,IAAI,IAAI,QAAQ,CAC7E,CAAC;AACJ,CAAC;KAAM,CAAC;IACN,MAAM,YAAY,EAAE,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AAC3D,CAAC"}

package/dist/bodies.d.ts

@@ -0,0 +1,38 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const DATASETS: {
+    readonly planets: {
+        readonly description: "Planets and dwarf planets of the Solar System.";
+        readonly data: import("@interstellar-tools/types").PlanetsType;
+    };
+    readonly moons: {
+        readonly description: "Natural satellites.";
+        readonly data: import("@interstellar-tools/types").MoonsType;
+    };
+    readonly stars: {
+        readonly description: "Stars (Alpha Centauri entries omitted pending a fix).";
+        readonly data: import("@interstellar-tools/types").StarInterface[];
+    };
+    readonly comets: {
+        readonly description: "Comets.";
+        readonly data: import("@interstellar-tools/types").CometsType;
+    };
+    readonly asteroids: {
+        readonly description: "Asteroids.";
+        readonly data: import("@interstellar-tools/types").AsteroidsType;
+    };
+    readonly 'asteroid-belts': {
+        readonly description: "Asteroid belts.";
+        readonly data: import("@interstellar-tools/types").AsteroidBeltsType;
+    };
+    readonly galaxies: {
+        readonly description: "Galaxies.";
+        readonly data: import("@interstellar-tools/types").GalaxiesType;
+    };
+    readonly systems: {
+        readonly description: "Planetary and stellar systems.";
+        readonly data: import("@interstellar-tools/types").SystemsType;
+    };
+};
+export type DatasetNameType = keyof typeof DATASETS;
+export declare const registerBodies: (server: McpServer) => void;
+//# sourceMappingURL=bodies.d.ts.map

package/dist/bodies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bodies.d.ts","sourceRoot":"","sources":["../src/bodies.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,SAAS,EAEV,MAAM,yCAAyC,CAAC;AAkBjD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAeX,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,QAAQ,CAAC;AAUpD,eAAO,MAAM,cAAc,GAAI,QAAQ,SAAS,SAmE/C,CAAC"}

package/dist/bodies.js

@@ -0,0 +1,87 @@
+import { ASTEROID_BELTS, ASTEROIDS, COMETS, GALAXIES, MOONS, PLANETS, STARS, SYSTEMS } from '@interstellar-tools/constants';
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { PURE_TOOL, result } from './tools/shared.js';
+/**
+ * The Alpha Centauri entries in `STARS` currently carry the Sun's galactic
+ * orbit instead of the binary + Proxima system, so they are held back until
+ * that model lands.
+ */
+const isTrusted = (body) => !(typeof body.system === 'object' &&
+    body.system !== null &&
+    'name' in body.system &&
+    body.system.name === 'Alpha Centauri');
+export const DATASETS = {
+    planets: {
+        description: 'Planets and dwarf planets of the Solar System.',
+        data: PLANETS
+    },
+    moons: { description: 'Natural satellites.', data: MOONS },
+    stars: {
+        description: 'Stars (Alpha Centauri entries omitted pending a fix).',
+        data: STARS.filter(isTrusted)
+    },
+    comets: { description: 'Comets.', data: COMETS },
+    asteroids: { description: 'Asteroids.', data: ASTEROIDS },
+    'asteroid-belts': { description: 'Asteroid belts.', data: ASTEROID_BELTS },
+    galaxies: { description: 'Galaxies.', data: GALAXIES },
+    systems: { description: 'Planetary and stellar systems.', data: SYSTEMS }
+};
+const DATASET_NAMES = Object.keys(DATASETS);
+const uriFor = (name) => `interstellar://datasets/${name}`;
+const UNITS_NOTE = 'Values carry their own units ({ value, unit }); `a` is usually in au, `period` in days (negative = integration direction), `radius` in km, `angle` in radians at J2000.';
+export const registerBodies = (server) => {
+    server.registerResource('dataset', new ResourceTemplate('interstellar://datasets/{name}', {
+        list: () => ({
+            resources: DATASET_NAMES.map((name) => ({
+                name,
+                uri: uriFor(name),
+                description: DATASETS[name].description,
+                mimeType: 'application/json'
+            }))
+        }),
+        complete: {
+            name: (value) => DATASET_NAMES.filter((name) => name.startsWith(value))
+        }
+    }), {
+        title: 'Celestial body dataset',
+        description: `Celestial body datasets from @interstellar-tools/constants. ${UNITS_NOTE}`,
+        mimeType: 'application/json'
+    }, (uri, { name }) => {
+        const dataset = DATASETS[String(name)];
+        if (!dataset)
+            throw new Error(`Unknown dataset: ${String(name)}`);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(dataset.data, null, 2)
+                }
+            ]
+        };
+    });
+    server.registerTool('find_body', {
+        title: 'Find celestial body',
+        description: `Look up celestial bodies by name (case-insensitive substring) across the bundled datasets. ${UNITS_NOTE} Bodies do not carry masses; use known μ values with the orbit tools.`,
+        inputSchema: {
+            query: z
+                .string()
+                .min(1)
+                .describe('Name or part of a name, e.g. "mars".'),
+            dataset: z
+                .enum(DATASET_NAMES)
+                .optional()
+                .describe('Restrict the search to one dataset.')
+        },
+        annotations: PURE_TOOL
+    }, ({ query, dataset }) => {
+        const needle = query.trim().toLowerCase();
+        const names = dataset ? [dataset] : DATASET_NAMES;
+        const matches = names.flatMap((name) => DATASETS[name].data
+            .filter((body) => body.name.toLowerCase().includes(needle))
+            .map((body) => ({ dataset: name, body })));
+        return result({ count: matches.length, matches });
+    });
+};
+//# sourceMappingURL=bodies.js.map

package/dist/bodies.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,23 @@
+import { type Server } from 'node:http';
+export interface HttpServerOptionsInterface {
+    /** Port to listen on. Use 0 for a random free port. */
+    port: number;
+    /** Interface to bind to. Defaults to loopback only. */
+    host?: string;
+    /** Path that serves MCP requests. */
+    path?: string;
+}
+/**
+ * Serve the MCP server over Streamable HTTP, for clients that only accept
+ * remote servers. Runs stateless: every request gets a fresh server, which is
+ * cheap because every tool is a pure calculation.
+ *
+ * @example
+ * ```ts
+ * import { startHttpServer } from '@interstellar-tools/mcp';
+ *
+ * await startHttpServer({ port: 3000 }); // http://127.0.0.1:3000/mcp
+ * ```
+ */
+export declare const startHttpServer: ({ port, host, path }: HttpServerOptionsInterface) => Promise<Server>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoC,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAI1E,MAAM,WAAW,0BAA0B;IACzC,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,sBAI7B,0BAA0B,KAAG,OAAO,CAAC,MAAM,CAyC7C,CAAC"}

package/dist/http.js

@@ -0,0 +1,51 @@
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { createServer as createHttpServer } from 'node:http';
+import { createServer } from './server.js';
+/**
+ * Serve the MCP server over Streamable HTTP, for clients that only accept
+ * remote servers. Runs stateless: every request gets a fresh server, which is
+ * cheap because every tool is a pure calculation.
+ *
+ * @example
+ * ```ts
+ * import { startHttpServer } from '@interstellar-tools/mcp';
+ *
+ * await startHttpServer({ port: 3000 }); // http://127.0.0.1:3000/mcp
+ * ```
+ */
+export const startHttpServer = ({ port, host = '127.0.0.1', path = '/mcp' }) => {
+    const http = createHttpServer(async (req, res) => {
+        const { pathname } = new URL(req.url ?? '/', 'http://localhost');
+        if (pathname !== path) {
+            res.writeHead(404, { 'content-type': 'text/plain' }).end('Not found');
+            return;
+        }
+        const server = createServer();
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+            enableJsonResponse: true
+        });
+        res.on('close', () => {
+            void transport.close();
+            void server.close();
+        });
+        try {
+            await server.connect(transport);
+            await transport.handleRequest(req, res);
+        }
+        catch (error) {
+            if (!res.headersSent) {
+                res.writeHead(500, { 'content-type': 'application/json' }).end(JSON.stringify({
+                    jsonrpc: '2.0',
+                    error: { code: -32603, message: String(error) },
+                    id: null
+                }));
+            }
+        }
+    });
+    return new Promise((resolve, reject) => {
+        http.once('error', reject);
+        http.listen(port, host, () => resolve(http));
+    });
+};
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAe,MAAM,WAAW,CAAC;AAE1E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAW3C;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAC9B,IAAI,EACJ,IAAI,GAAG,WAAW,EAClB,IAAI,GAAG,MAAM,EACc,EAAmB,EAAE;IAChD,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAC/C,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC;QAEjE,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAEtE,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;YAClD,kBAAkB,EAAE,SAAS;YAC7B,kBAAkB,EAAE,IAAI;SACzB,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,KAAK,SAAS,CAAC,KAAK,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChC,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,GAAG,CAC5D,IAAI,CAAC,SAAS,CAAC;oBACb,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE;oBAC/C,EAAE,EAAE,IAAI;iBACT,CAAC,CACH,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP server exposing interstellar-tools equations and datasets.
+ *
+ * @packageDocumentation
+ */
+export * from './http.js';
+export * from './server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,WAAW,CAAC;AAE1B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * MCP server exposing interstellar-tools equations and datasets.
+ *
+ * @packageDocumentation
+ */
+export * from './http.js';
+export * from './server.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,WAAW,CAAC;AAE1B,cAAc,aAAa,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,17 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const SERVER_NAME = "interstellar-tools";
+export declare const SERVER_VERSION = "0.0.0";
+/**
+ * Create an MCP server with every interstellar-tools tool and resource
+ * registered. Connect it to a transport of your choice.
+ *
+ * @example
+ * ```ts
+ * import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+ * import { createServer } from '@interstellar-tools/mcp';
+ *
+ * await createServer().connect(new StdioServerTransport());
+ * ```
+ */
+export declare const createServer: () => McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAEhD,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,QAAO,SAgB/B,CAAC"}

package/dist/server.js

@@ -0,0 +1,32 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerBodies } from './bodies.js';
+import { registerAnomalyTools } from './tools/anomalies.js';
+import { registerManoeuvreTools } from './tools/manoeuvres.js';
+import { registerOrbitTools } from './tools/orbits.js';
+import { registerTimeTools } from './tools/time.js';
+export const SERVER_NAME = 'interstellar-tools';
+export const SERVER_VERSION = '0.0.0';
+/**
+ * Create an MCP server with every interstellar-tools tool and resource
+ * registered. Connect it to a transport of your choice.
+ *
+ * @example
+ * ```ts
+ * import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+ * import { createServer } from '@interstellar-tools/mcp';
+ *
+ * await createServer().connect(new StdioServerTransport());
+ * ```
+ */
+export const createServer = () => {
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, {
+        instructions: 'Deterministic orbital mechanics calculations. All lengths are in metres, masses in kg, speeds in m/s and μ in m³/s² unless a field name says otherwise. Angles are given as { value, unit: "deg" | "rad" }. Prefer these tools over mental arithmetic.'
+    });
+    registerOrbitTools(server);
+    registerManoeuvreTools(server);
+    registerAnomalyTools(server);
+    registerTimeTools(server);
+    registerBodies(server);
+    return server;
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEhD,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAc,EAAE;IAC1C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAC9C;QACE,YAAY,EACV,wPAAwP;KAC3P,CACF,CAAC;IAEF,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/tools/anomalies.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerAnomalyTools: (server: McpServer) => void;
+//# sourceMappingURL=anomalies.d.ts.map

package/dist/tools/anomalies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anomalies.d.ts","sourceRoot":"","sources":["../../src/tools/anomalies.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsCzE,eAAO,MAAM,oBAAoB,GAAI,QAAQ,SAAS,SAsCrD,CAAC"}

package/dist/tools/anomalies.js

@@ -0,0 +1,51 @@
+import { eccentricToTrueAnomaly, norm2pi, solveKepler, trueToMeanAnomaly } from '@interstellar-tools/equations';
+import { z } from 'zod';
+import { angleOutput, angleOutputSchema, angleSchema, PURE_TOOL, result, toRadians } from './shared.js';
+const ANOMALIES = ['mean', 'eccentric', 'true'];
+const eccentricitySchema = z
+    .number()
+    .min(0)
+    .lt(1)
+    .describe('Eccentricity of an elliptic orbit, 0 ≤ e < 1.');
+// Every conversion goes through the library: mean → eccentric via Kepler’s
+// equation, eccentric → true directly, and true → mean directly.
+const toMean = (kind, x, e) => {
+    if (kind === 'mean')
+        return x;
+    const nu = kind === 'true' ? x : eccentricToTrueAnomaly(x, e);
+    return trueToMeanAnomaly(nu, e);
+};
+const fromMean = (kind, M, e) => {
+    if (kind === 'mean')
+        return M;
+    const E = solveKepler(M, e);
+    return kind === 'eccentric' ? E : eccentricToTrueAnomaly(E, e);
+};
+export const registerAnomalyTools = (server) => {
+    server.registerTool('solve_kepler', {
+        title: 'Solve Kepler’s equation',
+        description: 'Solve Kepler’s equation M = E − e·sin(E) for the eccentric anomaly E, given mean anomaly M and eccentricity e (elliptic orbits). Robust up to e → 1.',
+        inputSchema: { M: angleSchema, e: eccentricitySchema },
+        outputSchema: { E: angleOutputSchema },
+        annotations: PURE_TOOL
+    }, ({ M, e }) => result({ E: angleOutput(solveKepler(toRadians(M), e)) }));
+    server.registerTool('convert_anomaly', {
+        title: 'Convert orbital anomaly',
+        description: 'Convert between mean, eccentric and true anomaly for an elliptic orbit. Results are normalised to [0, 2π).',
+        inputSchema: {
+            from: z.enum(ANOMALIES).describe('Kind of the input anomaly.'),
+            to: z.enum(ANOMALIES).describe('Kind of anomaly to return.'),
+            angle: angleSchema,
+            e: eccentricitySchema
+        },
+        outputSchema: { kind: z.enum(ANOMALIES), angle: angleOutputSchema },
+        annotations: PURE_TOOL
+    }, ({ from, to, angle, e }) => {
+        const M = toMean(from, toRadians(angle), e);
+        return result({
+            kind: to,
+            angle: angleOutput(norm2pi(fromMean(to, M, e)))
+        });
+    });
+};
+//# sourceMappingURL=anomalies.js.map

package/dist/tools/anomalies.js.map

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

package/dist/tools/manoeuvres.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerManoeuvreTools: (server: McpServer) => void;
+//# sourceMappingURL=manoeuvres.d.ts.map

package/dist/tools/manoeuvres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manoeuvres.d.ts","sourceRoot":"","sources":["../../src/tools/manoeuvres.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,eAAO,MAAM,sBAAsB,GAAI,QAAQ,SAAS,SA8FvD,CAAC"}

package/dist/tools/manoeuvres.js

@@ -0,0 +1,73 @@
+import { SECONDS_PER_DAY } from '@interstellar-tools/constants';
+import { hohmannTransfer, planeChangeDeltaV, rocketDeltaVFromIsp } from '@interstellar-tools/equations';
+import { z } from 'zod';
+import { angleSchema, muSchema, PURE_TOOL, result, toRadians } from './shared.js';
+const directionSchema = z.enum(['prograde', 'retrograde', 'none']);
+export const registerManoeuvreTools = (server) => {
+    server.registerTool('hohmann_transfer', {
+        title: 'Hohmann transfer',
+        description: 'Two-impulse Hohmann transfer between coplanar circular orbits of radius r1 and r2 around the same body. Returns both burns, total Δv and transfer time.',
+        inputSchema: {
+            r1_m: z
+                .number()
+                .positive()
+                .describe('Initial circular orbit radius from body centre, in metres.'),
+            r2_m: z
+                .number()
+                .positive()
+                .describe('Target circular orbit radius from body centre, in metres.'),
+            mu_m3_s2: muSchema
+        },
+        outputSchema: {
+            a_transfer_m: z.number(),
+            dv1_m_s: z.number(),
+            dv2_m_s: z.number(),
+            dv_total_m_s: z.number(),
+            t_transfer_s: z.number(),
+            t_transfer_d: z.number(),
+            burn1_direction: directionSchema,
+            burn2_direction: directionSchema
+        },
+        annotations: PURE_TOOL
+    }, ({ r1_m, r2_m, mu_m3_s2 }) => {
+        const { at, dv1, dv2, dvTotal, tTransfer, dir1, dir2 } = hohmannTransfer(r1_m, r2_m, mu_m3_s2);
+        return result({
+            a_transfer_m: at,
+            dv1_m_s: dv1,
+            dv2_m_s: dv2,
+            dv_total_m_s: dvTotal,
+            t_transfer_s: tTransfer,
+            t_transfer_d: tTransfer / SECONDS_PER_DAY,
+            burn1_direction: dir1,
+            burn2_direction: dir2
+        });
+    });
+    server.registerTool('rocket_delta_v', {
+        title: 'Rocket equation Δv',
+        description: 'Tsiolkovsky rocket equation from specific impulse: Δv = g0·Isp·ln(m0/mf).',
+        inputSchema: {
+            isp_s: z.number().positive().describe('Specific impulse, in seconds.'),
+            m0_kg: z.number().positive().describe('Initial (wet) mass, in kg.'),
+            mf_kg: z
+                .number()
+                .positive()
+                .describe('Final (dry) mass, in kg. Must be less than m0_kg.')
+        },
+        outputSchema: { dv_m_s: z.number() },
+        annotations: PURE_TOOL
+    }, ({ isp_s, m0_kg, mf_kg }) => result({ dv_m_s: rocketDeltaVFromIsp(isp_s, m0_kg, mf_kg) }));
+    server.registerTool('plane_change_delta_v', {
+        title: 'Plane change Δv',
+        description: 'Δv for a pure inclination change at constant speed: Δv = 2v·sin(Δi/2). Δi must be within [0°, 180°].',
+        inputSchema: {
+            v_m_s: z
+                .number()
+                .nonnegative()
+                .describe('Orbital speed at the burn point, in m/s.'),
+            delta_i: angleSchema
+        },
+        outputSchema: { dv_m_s: z.number() },
+        annotations: PURE_TOOL
+    }, ({ v_m_s, delta_i }) => result({ dv_m_s: planeChangeDeltaV(v_m_s, toRadians(delta_i)) }));
+};
+//# sourceMappingURL=manoeuvres.js.map

package/dist/tools/manoeuvres.js.map

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

package/dist/tools/orbits.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerOrbitTools: (server: McpServer) => void;
+//# sourceMappingURL=orbits.d.ts.map

package/dist/tools/orbits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orbits.d.ts","sourceRoot":"","sources":["../../src/tools/orbits.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,eAAO,MAAM,kBAAkB,GAAI,QAAQ,SAAS,SA2InD,CAAC"}

package/dist/tools/orbits.js

@@ -0,0 +1,100 @@
+import { SECONDS_PER_DAY } from '@interstellar-tools/constants';
+import { circularSpeed, escapeSpeed, gravitationalParameter, keplerPeriod, periApoapsisRadii, sphereOfInfluenceRadius, visVivaSpeed } from '@interstellar-tools/equations';
+import { z } from 'zod';
+import { muSchema, PURE_TOOL, result } from './shared.js';
+const radiusSchema = z
+    .number()
+    .positive()
+    .describe('Distance from the centre of the central body, in metres (m).');
+export const registerOrbitTools = (server) => {
+    server.registerTool('gravitational_parameter', {
+        title: 'Gravitational parameter',
+        description: 'Compute the standard gravitational parameter μ = G·(M + m) from masses. Use this to get μ for the other orbit tools.',
+        inputSchema: {
+            M_kg: z.number().nonnegative().describe('Primary mass, in kg.'),
+            m_kg: z
+                .number()
+                .nonnegative()
+                .default(0)
+                .describe('Secondary mass, in kg. Omit for a test particle.')
+        },
+        outputSchema: { mu_m3_s2: z.number() },
+        annotations: PURE_TOOL
+    }, ({ M_kg, m_kg }) => result({ mu_m3_s2: gravitationalParameter(M_kg, m_kg) }));
+    server.registerTool('circular_speed', {
+        title: 'Circular orbit speed',
+        description: 'Speed of a circular orbit at radius r: v = √(μ/r).',
+        inputSchema: { r_m: radiusSchema, mu_m3_s2: muSchema },
+        outputSchema: { v_m_s: z.number() },
+        annotations: PURE_TOOL
+    }, ({ r_m, mu_m3_s2 }) => result({ v_m_s: circularSpeed(r_m, mu_m3_s2) }));
+    server.registerTool('escape_speed', {
+        title: 'Escape speed',
+        description: 'Escape speed at radius r: v = √(2μ/r).',
+        inputSchema: { r_m: radiusSchema, mu_m3_s2: muSchema },
+        outputSchema: { v_m_s: z.number() },
+        annotations: PURE_TOOL
+    }, ({ r_m, mu_m3_s2 }) => result({ v_m_s: escapeSpeed(r_m, mu_m3_s2) }));
+    server.registerTool('vis_viva_speed', {
+        title: 'Vis-viva speed',
+        description: 'Orbital speed at radius r on an orbit with semi-major axis a: v = √(μ(2/r − 1/a)). Use a > 0 for elliptic orbits and a < 0 for hyperbolic orbits.',
+        inputSchema: {
+            r_m: radiusSchema,
+            a_m: z
+                .number()
+                .finite()
+                .refine((a) => a !== 0, 'a must be non-zero')
+                .describe('Semi-major axis, in metres. Positive for elliptic, negative for hyperbolic.'),
+            mu_m3_s2: muSchema
+        },
+        outputSchema: { v_m_s: z.number() },
+        annotations: PURE_TOOL
+    }, ({ r_m, a_m, mu_m3_s2 }) => result({ v_m_s: visVivaSpeed(r_m, a_m, mu_m3_s2) }));
+    server.registerTool('kepler_period', {
+        title: 'Orbital period',
+        description: 'Orbital period of an elliptic orbit from Kepler’s third law: T = 2π√(a³/μ).',
+        inputSchema: {
+            a_m: z.number().positive().describe('Semi-major axis, in metres.'),
+            mu_m3_s2: muSchema
+        },
+        outputSchema: { T_s: z.number(), T_d: z.number() },
+        annotations: PURE_TOOL
+    }, ({ a_m, mu_m3_s2 }) => {
+        const T_s = keplerPeriod(a_m, mu_m3_s2);
+        return result({ T_s, T_d: T_s / SECONDS_PER_DAY });
+    });
+    server.registerTool('peri_apoapsis_radii', {
+        title: 'Periapsis and apoapsis radii',
+        description: 'Periapsis rp = a(1 − e) and apoapsis ra = a(1 + e). For hyperbolic orbits (a < 0, e > 1) ra is null.',
+        inputSchema: {
+            a_m: z
+                .number()
+                .finite()
+                .describe('Semi-major axis, in metres. Negative for hyperbolic orbits.'),
+            e: z.number().nonnegative().describe('Eccentricity (dimensionless).')
+        },
+        outputSchema: { rp_m: z.number(), ra_m: z.number().nullable() },
+        annotations: PURE_TOOL
+    }, ({ a_m, e }) => {
+        const { rp, ra } = periApoapsisRadii(a_m, e);
+        return result({ rp_m: rp, ra_m: ra });
+    });
+    server.registerTool('sphere_of_influence_radius', {
+        title: 'Sphere of influence',
+        description: 'Laplace sphere-of-influence radius of a secondary body orbiting a primary: r_SOI = a·(m/M)^(2/5).',
+        inputSchema: {
+            a_m: z
+                .number()
+                .positive()
+                .describe('Semi-major axis of the secondary around the primary, in metres.'),
+            m_kg: z
+                .number()
+                .positive()
+                .describe('Secondary (smaller) mass, in kg.'),
+            M_kg: z.number().positive().describe('Primary (larger) mass, in kg.')
+        },
+        outputSchema: { r_soi_m: z.number() },
+        annotations: PURE_TOOL
+    }, ({ a_m, m_kg, M_kg }) => result({ r_soi_m: sphereOfInfluenceRadius(a_m, m_kg, M_kg) }));
+};
+//# sourceMappingURL=orbits.js.map

package/dist/tools/orbits.js.map

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

package/dist/tools/shared.d.ts

@@ -0,0 +1,39 @@
+import type { Radians } from '@interstellar-tools/types';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+/** Standard gravitational parameter input, shared by most orbit tools. */
+export declare const muSchema: z.ZodNumber;
+/** Angle input that accepts either degrees or radians. */
+export declare const angleSchema: z.ZodObject<{
+    value: z.ZodNumber;
+    unit: z.ZodEnum<{
+        deg: "deg";
+        rad: "rad";
+    }>;
+}, z.core.$strip>;
+export type AngleInputType = z.infer<typeof angleSchema>;
+/** Angle output carrying both radians and degrees. */
+export declare const angleOutputSchema: z.ZodObject<{
+    rad: z.ZodNumber;
+    deg: z.ZodNumber;
+}, z.core.$strip>;
+export declare const toRadians: ({ value, unit }: AngleInputType) => Radians;
+export declare const angleOutput: (rad: number) => {
+    rad: number;
+    deg: number;
+};
+/**
+ * Wraps a structured result so clients get both machine-readable
+ * `structuredContent` and a JSON text block for models that only read text.
+ */
+export declare const result: <T extends Record<string, unknown>>(data: T) => CallToolResult & {
+    structuredContent: T;
+};
+/** Tool annotations shared by every calculation tool: pure, offline, deterministic. */
+export declare const PURE_TOOL: {
+    readonly readOnlyHint: true;
+    readonly destructiveHint: false;
+    readonly idempotentHint: true;
+    readonly openWorldHint: false;
+};
+//# sourceMappingURL=shared.d.ts.map

package/dist/tools/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,0EAA0E;AAC1E,eAAO,MAAM,QAAQ,aAKlB,CAAC;AAEJ,0DAA0D;AAC1D,eAAO,MAAM,WAAW;;;;;;iBAKuD,CAAC;AAEhF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEzD,sDAAsD;AACtD,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AAEH,eAAO,MAAM,SAAS,GAAI,iBAAiB,cAAc,KAAG,OACR,CAAC;AAErD,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM;;;CAGrC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtD,MAAM,CAAC,KACN,cAAc,GAAG;IAAE,iBAAiB,EAAE,CAAC,CAAA;CAGxC,CAAC;AAEH,uFAAuF;AACvF,eAAO,MAAM,SAAS;;;;;CAKZ,CAAC"}

package/dist/tools/shared.js

@@ -0,0 +1,40 @@
+import { toRad } from '@interstellar-tools/equations';
+import { z } from 'zod';
+/** Standard gravitational parameter input, shared by most orbit tools. */
+export const muSchema = z
+    .number()
+    .positive()
+    .describe('Standard gravitational parameter μ = G·M of the central body, in m³/s². Earth ≈ 3.986004418e14, Sun ≈ 1.32712440018e20.');
+/** Angle input that accepts either degrees or radians. */
+export const angleSchema = z
+    .object({
+    value: z.number().finite(),
+    unit: z.enum(['deg', 'rad'])
+})
+    .describe('Angle with explicit unit, e.g. { "value": 28.5, "unit": "deg" }.');
+/** Angle output carrying both radians and degrees. */
+export const angleOutputSchema = z.object({
+    rad: z.number(),
+    deg: z.number()
+});
+export const toRadians = ({ value, unit }) => unit === 'deg' ? toRad(value) : value;
+export const angleOutput = (rad) => ({
+    rad,
+    deg: (rad * 180) / Math.PI
+});
+/**
+ * Wraps a structured result so clients get both machine-readable
+ * `structuredContent` and a JSON text block for models that only read text.
+ */
+export const result = (data) => ({
+    content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+    structuredContent: data
+});
+/** Tool annotations shared by every calculation tool: pure, offline, deterministic. */
+export const PURE_TOOL = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+};
+//# sourceMappingURL=shared.js.map

package/dist/tools/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAGtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,0EAA0E;AAC1E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CACP,yHAAyH,CAC1H,CAAC;AAEJ,0DAA0D;AAC1D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;IAC1B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CAC7B,CAAC;KACD,QAAQ,CAAC,kEAAkE,CAAC,CAAC;AAIhF,sDAAsD;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;CAChB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAkB,EAAW,EAAE,CACpE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAiB,CAAC;AAErD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC;IAC3C,GAAG;IACH,GAAG,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE;CAC3B,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,IAAO,EACoC,EAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IAChE,iBAAiB,EAAE,IAAI;CACxB,CAAC,CAAC;AAEH,uFAAuF;AACvF,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,KAAK;CACZ,CAAC"}

package/dist/tools/time.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerTimeTools: (server: McpServer) => void;
+//# sourceMappingURL=time.d.ts.map

package/dist/tools/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/tools/time.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,eAAO,MAAM,iBAAiB,GAAI,QAAQ,SAAS,SAwBlD,CAAC"}

package/dist/tools/time.js

@@ -0,0 +1,24 @@
+import { convertTemporalUnit, normalizeTemporalUnit } from '@interstellar-tools/temporal';
+import { z } from 'zod';
+import { PURE_TOOL, result } from './shared.js';
+const unitSchema = z
+    .string()
+    .min(1)
+    .describe('Time unit: s, ms, μs (or us), ns, ps, fs, as, zs, ys, min, h, d, yr, kyr, Myr, Gyr, or a long form such as "days" or "megayears". Years are Julian years (365.25 d).');
+export const registerTimeTools = (server) => {
+    server.registerTool('convert_time', {
+        title: 'Convert time unit',
+        description: 'Convert a duration between time units, from attoseconds to gigayears.',
+        inputSchema: {
+            value: z.number().finite().describe('Duration in the `from` unit.'),
+            from: unitSchema,
+            to: unitSchema
+        },
+        outputSchema: { value: z.number(), unit: z.string() },
+        annotations: PURE_TOOL
+    }, ({ value, from, to }) => {
+        const { value: converted, unit } = convertTemporalUnit({ value, unit: normalizeTemporalUnit(from) }, normalizeTemporalUnit(to));
+        return result({ value: converted, unit });
+    });
+};
+//# sourceMappingURL=time.js.map

package/dist/tools/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/tools/time.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACP,sKAAsK,CACvK,CAAC;AAEJ,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAiB,EAAE,EAAE;IACrD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,uEAAuE;QACzE,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;YACnE,IAAI,EAAE,UAAU;YAChB,EAAE,EAAE,UAAU;SACf;QACD,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;QACrD,WAAW,EAAE,SAAS;KACvB,EACD,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE;QACtB,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,mBAAmB,CACpD,EAAE,KAAK,EAAE,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC,EAAE,EAC5C,qBAAqB,CAAC,EAAE,CAAC,CAC1B,CAAC;QAEF,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,76 @@
 {
   "name": "@interstellar-tools/mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.0",
+  "description": "Model Context Protocol (MCP) server exposing interstellar-tools orbital mechanics equations and celestial body datasets to AI assistants.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "mcp-server",
+    "interstellar",
+    "tools",
+    "astrodynamics",
+    "orbital-mechanics",
+    "celestial-mechanics",
+    "kepler",
+    "hohmann-transfer",
+    "delta-v",
+    "vis-viva",
+    "planets",
+    "moons",
+    "interstellar-tools"
+  ],
+  "homepage": "https://phun-ky.net/projects/interstellar-tools",
+  "bugs": {
+    "url": "https://github.com/phun-ky/interstellar-tools/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/phun-ky/interstellar-tools.git"
+  },
+  "funding": "https://github.com/phun-ky/interstellar-tools?sponsor=1",
+  "license": "MIT",
+  "author": "Alexander Vassbotn Røyne-Helgesen <alexander@phun-ky.net>",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "interstellar-tools-mcp": "dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "typecheck": "tsc -p tsconfig.json",
+    "release": "release-it",
+    "start": "node dist/bin.js",
+    "test": "tsx --test **/__tests__/**/*.spec.ts",
+    "pretest:ci": "rm -rf coverage && mkdir -p coverage",
+    "test:ci": "glob-bin -c \"node --import tsx --test --no-warnings --experimental-test-coverage --test-reporter=cobertura --test-reporter-destination=coverage/cobertura-coverage.xml --test-reporter=spec --test-reporter-destination=stdout\" \"**/__tests__/**/*.spec.ts\""
+  },
+  "dependencies": {
+    "@interstellar-tools/constants": "^0.60.0",
+    "@interstellar-tools/equations": "^0.60.0",
+    "@interstellar-tools/temporal": "^0.60.0",
+    "@interstellar-tools/types": "^0.60.0",
+    "@modelcontextprotocol/sdk": "1.31.0",
+    "zod": "4.6.5"
+  },
+  "devDependencies": {
+    "@types/node": "^24.19.2",
+    "prettier": "^3.9.10",
+    "typescript": "^6.0.3"
+  },
+  "engines": {
+    "node": ">=22.9.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}