@mrfentmen/exoplanet-archive-mcp 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# NASA Exoplanet Archive 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.
+Confirmed exoplanets with host stars and discovery data from NASA. Keyless — no signup, no API key, no environment variables.
+
+## Install
+
+```bash
+npx -y @mrfentmen/exoplanet-archive-mcp
+```
+
+Or add it to your MCP client:
+
+```json
+{
+  "mcpServers": {
+    "exoplanet-archive-mcp": { "command": "npx", "args": ["-y", "@mrfentmen/exoplanet-archive-mcp"] }
+  }
+}
+```
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `search_planets` | Find exoplanets by name |
+
+## Notes
+
+Queries run through the archive TAP service. The table pscomppars holds one row per confirmed planet.
+
+## Licence
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,3 @@
+export declare class ExoplanetArchiveError extends Error {
+}
+export declare function searchPlanets(name: string, limit?: number): Promise<string>;

package/dist/api.js

@@ -0,0 +1,64 @@
+/**
+ * NASA Exoplanet Archive — Confirmed exoplanets with host stars and discovery data from NASA. Keyless: no signup, no API key, no environment variables.
+ *
+ * Verified live against exoplanetarchive.ipac.caltech.edu.
+ */
+const API = "https://exoplanetarchive.ipac.caltech.edu/TAP/sync";
+export class ExoplanetArchiveError extends Error {
+}
+const val = (v) => {
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number")
+        return Number.isFinite(v) ? String(v) : "";
+    if (Array.isArray(v))
+        return v.length > 0 ? val(v[0]) : "";
+    if (v && typeof v === "object") {
+        const o = v;
+        if ("en" in o)
+            return val(o.en);
+        const first = Object.values(o)[0];
+        return first === undefined ? "" : val(first);
+    }
+    return "";
+};
+const at = (o, path) => path === "" ? o : path.split(".").reduce((acc, k) => (acc && typeof acc === "object" ? acc[k] : undefined), o);
+const rows = (v) => (Array.isArray(v) ? v : []);
+async function get(url, init, timeoutMs = 25000) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, {
+            ...init,
+            signal: ctrl.signal,
+            headers: { "user-agent": "exoplanet-archive-mcp", accept: "application/json", ...(init?.headers ?? {}) },
+        });
+        if (!res.ok)
+            throw new ExoplanetArchiveError(`NASA Exoplanet Archive returned HTTP ${res.status}`);
+        return (await res.json());
+    }
+    catch (e) {
+        if (e instanceof ExoplanetArchiveError)
+            throw e;
+        if (e.name === "AbortError")
+            throw new ExoplanetArchiveError("NASA Exoplanet Archive request timed out");
+        throw new ExoplanetArchiveError(`NASA Exoplanet Archive request failed: ${e.message}`);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function searchPlanets(name, limit = 5) {
+    const q = name.trim();
+    if (q === "")
+        throw new ExoplanetArchiveError("name must not be empty");
+    const size = Math.min(25, Math.max(1, limit));
+    const safe = q.replace(/'/g, "");
+    const sql = `select top ${size} pl_name,hostname,disc_year,discoverymethod from pscomppars where pl_name like '%${safe}%'`;
+    const body = await get(`${API}?query=${encodeURIComponent(sql)}&format=json`);
+    const items = rows(body);
+    if (items.length === 0)
+        return `The archive has no planets matching "${q}".`;
+    const lines = items.map((r, i) => `${i + 1}. ${val(at(r, "pl_name"))} — ${val(at(r, "hostname"))} (${val(at(r, "disc_year"))}, ${val(at(r, "discoverymethod"))})`);
+    return [`Exoplanets matching "${q}" — ${items.length} shown`, "", ...lines].join("\n");
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("exoplanet-archive-mcp running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,18 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { searchPlanets } from "./api.js";
+const text = (t) => ({ content: [{ type: "text", text: t }] });
+const fail = (t) => ({ content: [{ type: "text", text: t }], isError: true });
+const errorMessage = (e) => `Error: ${e instanceof Error ? e.message : String(e)}`;
+export function createServer() {
+    const server = new McpServer({ name: "exoplanet-archive-mcp", version: "1.0.0" });
+    server.tool("search_planets", "Find exoplanets by name", { name: z.string().min(1).describe("Planet or host name, e.g. Kepler"), limit: z.number().int().min(1).max(25).default(5).describe("How many planets") }, async ({ name, limit }) => {
+        try {
+            return text(await searchPlanets(name, limit));
+        }
+        catch (e) {
+            return fail(errorMessage(e));
+        }
+    });
+    return server;
+}

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@mrfentmen/exoplanet-archive-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "NASA Exoplanet Archive: confirmed exoplanets, host stars and discovery year - keyless.",
+  "type": "module",
+  "mcpName": "io.github.mrfentmen/exoplanet-archive-mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mrfentmen/awesome-servers.git"
+  },
+  "bin": {
+    "exoplanet-archive-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "test": "node tests/smoke.mjs"
+  },
+  "keywords": [
+    "mcp",
+    "exoplanet-archive",
+    "space",
+    "exoplanets",
+    "astronomy",
+    "nasa",
+    "keyless"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}