@openephemeris/mcp-server 3.2.4 → 3.2.7

package/dist/src/backend/client.js

@@ -256,6 +256,10 @@ export class BackendClient {
             if (status >= 500)
                 return new BackendError(`Backend error (${status}): ${msg}`, status, "server_error", true);
         }
+        // Explicit timeout or abort interception
+        if (error.code === "ECONNABORTED" || error.code === "ETIMEDOUT") {
+            return new BackendError(`The computation took too long and timed out. This usually happens when requesting a massive date range (like 20+ years of transits) or an overly complex query. Please narrow your request and try again.`, 408, "timeout", false);
+        }
         return new BackendError(`Network error: ${error.message}`, 0, "network_error", true);
     }
     async get(path, params, timeoutMs) {

package/dist/src/index.js

@@ -4,7 +4,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { initTools, toolRegistry } from "./tools/index.js";
 function resolveServerVersion() {
     try {
@@ -33,6 +33,7 @@ const server = new Server({
 }, {
     capabilities: {
         tools: {},
+        prompts: {},
     },
 });
 // List available tools
@@ -50,6 +51,47 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         })),
     };
 });
+// List available prompts
+server.setRequestHandler(ListPromptsRequestSchema, async () => {
+    return {
+        prompts: [
+            {
+                name: "welcome_to_open_ephemeris",
+                description: "Getting started guide for the Open Ephemeris MCP. Use this to orient yourself to available tools, astrology terminology, and usage.",
+            }
+        ]
+    };
+});
+// Get prompt content
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    if (request.params.name !== "welcome_to_open_ephemeris") {
+        throw new Error(`Unknown prompt: ${request.params.name}`);
+    }
+    return {
+        description: "Open Ephemeris Agent & Developer Orientation",
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: "Welcome to the **Open Ephemeris MCP Server**!\n\n" +
+                        "You are now connected to an enterprise-grade astrological and astronomical computation engine powered by NASA JPL DE440 and DE441 ephemeris data. As a generative guide, here is how you can best utilize these tools to help the user:\n\n" +
+                        "### Core Capabilities\n" +
+                        "- **Birth Charts:** Use `ephemeris_natal_chart` for full planetary positions, houses, dignities, and aspects.\n" +
+                        "- **Predictive Timing:** `ephemeris_transits` searches for exact dates when transiting planets hit natal points.\n" +
+                        "- **Location Astrology:** `ephemeris_relocation` projects a natal chart to a new geographic location (Astrocartography).\n" +
+                        "- **Specialized Modalities:** Dedicated tools for `vedic_chart`, `chinese_bazi`, and `human_design_chart`.\n" +
+                        "- **Eclipse Hunter:** `ephemeris_next_eclipse` dynamically scans 20 years for the next total or partial hit at the user's location.\n\n" +
+                        "### Best Practices for AI Agents\n" +
+                        "1. **Coordinate Formatting:** Always convert addresses/city names into `latitude` and `longitude` decimals *before* calling the tools (e.g., Chicago is `41.8781, -87.6298`).\n" +
+                        "2. **Datetime Handling:** Most endpoints accept ISO 8601 strings. If you have a local birth time but the endpoint asks for UTC, explicitly append a `Z` or timezone offset (e.g., `1990-04-15T19:30:00Z`).\n" +
+                        "3. **Token Efficiency:** Our responses are hyper-condensed to save you context space. You don't need to struggle with raw JSON arrays; interpret the condensed strings directly (e.g., `Su 15°Pi30 H10`).\n\n" +
+                        "You're equipped with professional-grade math. Start by asking the user if they'd like to calculate a natal chart, check recent transits, or explore another modality!"
+                }
+            }
+        ]
+    };
+});
 // Handle tool calls
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const toolName = request.params.name;
@@ -57,19 +99,44 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     if (!tool) {
         throw new Error(`Unknown tool: ${toolName}`);
     }
+    const startTime = Date.now();
+    console.error(`[MCP] Executing tool: ${toolName}`);
     try {
         const result = await tool.handler(request.params.arguments ?? {});
+        const durationMs = Date.now() - startTime;
+        console.error(`[MCP] ✅ Success: ${toolName} (${durationMs}ms)`);
+        const jsonStr = JSON.stringify(result, null, 2);
+        // Safety limit: ~100kb JSON is roughly 20-30k tokens. 
+        // Usually happens if LLMs ask for 50+ years of transits or raw ephemeris arrays.
+        if (jsonStr.length > 100_000) {
+            console.error(`[MCP] ⚠️ Warning: Payload too large (${(jsonStr.length / 1024).toFixed(1)}kb) for ${toolName}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: false,
+                            error: "PAYLOAD_TOO_LARGE",
+                            message: `The requested query produced too much data (${(jsonStr.length / 1024).toFixed(1)}kb). Please significantly narrow your request parameters (e.g., fewer years, smaller coordinate bounding box, etc.) to fit within context limits.`
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
         return {
             content: [
                 {
                     type: "text",
-                    text: JSON.stringify(result, null, 2),
+                    text: jsonStr,
                 },
             ],
         };
     }
     catch (error) {
+        const durationMs = Date.now() - startTime;
         const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(`[MCP] ❌ Failed: ${toolName} (${durationMs}ms) - ${errorMessage}`);
         return {
             content: [
                 {

package/dist/src/tools/specialized/natal.js

@@ -70,10 +70,15 @@ registerTool({
             const code = HOUSE_SYSTEM_MAP[args.house_system] ?? args.house_system;
             body.configuration = { house_system: code };
         }
-        if (args.include_arabic_parts || args.include_fixed_stars) {
+        if (args.include_fixed_stars) {
+            body.configuration = {
+                ...(body.configuration || {}),
+                fixed_star_options: { include: true }
+            };
+        }
+        if (args.include_arabic_parts) {
             body.options = {
-                ...(args.include_arabic_parts && { include_arabic_parts: args.include_arabic_parts }),
-                ...(args.include_fixed_stars && { include_fixed_stars: args.include_fixed_stars }),
+                include_hermetic_lots: true,
             };
         }
         const query = {};

package/dist/src/tools/specialized/transits.js

@@ -70,6 +70,11 @@ registerTool({
         const body = {
             start_date: startStr,
             end_date: endStr,
+            natal_chart: {
+                datetime: args.natal_datetime,
+                latitude: args.natal_latitude,
+                longitude: args.natal_longitude,
+            },
         };
         if (args.transiting_planets)
             body.planet_names = args.transiting_planets;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openephemeris/mcp-server",
-  "version": "3.2.4",
+  "version": "3.2.7",
   "description": "Model Context Protocol server for the Open Ephemeris astronomical computation API",
   "type": "module",
   "main": "dist/index.js",
@@ -42,7 +42,11 @@
     "astrology",
     "astronomy",
     "ephemeris",
-    "openephemeris"
+    "openephemeris",
+    "llm",
+    "claude",
+    "ai",
+    "swiss ephemeris"
   ],
   "author": "Open Ephemeris",
   "license": "MIT",