@openephemeris/mcp-server 3.3.0 → 3.3.1

package/dist/index.js

@@ -5,7 +5,7 @@ import { fileURLToPath } from "node:url";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { initTools, toolRegistry } from "./tools/index.js";
+import { initTools, toolRegistry, formatToolResponse } from "./tools/index.js";
 function resolveServerVersion() {
     try {
         const here = path.dirname(fileURLToPath(import.meta.url));
@@ -104,53 +104,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     try {
         const result = await tool.handler(request.params.arguments ?? {});
         const durationMs = Date.now() - startTime;
-        console.error(`[MCP] ✅ Success: ${toolName} (${durationMs}ms)`);
-        // Intercept binary backend responses (like Chart Wheels) to return native MCP Images
-        if (result &&
-            typeof result === "object" &&
-            "encoding" in result &&
-            result.encoding === "base64" &&
-            "data_base64" in result &&
-            "content_type" in result) {
-            const binResp = result;
-            console.error(`[MCP] 🎨 Returning image (${binResp.content_length} bytes) for ${toolName}`);
-            return {
-                content: [
-                    {
-                        type: "image",
-                        data: binResp.data_base64,
-                        mimeType: binResp.content_type,
-                    },
-                ],
-            };
-        }
-        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: jsonStr,
-                },
-            ],
-        };
+        return formatToolResponse(toolName, result, durationMs);
     }
     catch (error) {
         const durationMs = Date.now() - startTime;

package/dist/server-sse.js

@@ -20,7 +20,7 @@ import axios from "axios";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { initTools, toolRegistry } from "./tools/index.js";
+import { initTools, toolRegistry, formatToolResponse } from "./tools/index.js";
 import { backendClient } from "./backend/client.js";
 // ---------------------------------------------------------------------------
 // Helpers
@@ -108,13 +108,16 @@ function createMcpServer() {
             throw new Error(`Unknown tool: ${toolName}`);
         }
         try {
+            const startTime = Date.now();
+            console.error(`[MCP] Executing tool: ${toolName}`);
             const result = await tool.handler(request.params.arguments ?? {});
-            return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-            };
+            const durationMs = Date.now() - startTime;
+            return formatToolResponse(toolName, result, durationMs);
         }
         catch (error) {
+            const startTime = Date.now(); // Not strictly accurate for errors but acceptable for logging structure if needed
             const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`[MCP] \u274c Failed: ${toolName} - ${errorMessage}`);
             return {
                 content: [
                     {

package/dist/tools/index.d.ts

@@ -31,3 +31,28 @@ export declare function validateRequired(args: any, requiredKeys: string[]): voi
  * Throws an error if only one of the coordinate pair is provided.
  */
 export declare function validateCoordinates(args: any, latKey: string, lonKey: string): void;
+/**
+ * Formats a raw tool response into native MCP content blocks.
+ * Intercepts binary image responses (like Chart Wheels) and returns them as native MCP Images.
+ * Applies a safety limit to JSON payloads to prevent crashing LLM contexts.
+ */
+export declare function formatToolResponse(toolName: string, result: any, durationMs: number): {
+    content: {
+        type: string;
+        data: string;
+        mimeType: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+};

package/dist/tools/index.js

@@ -66,3 +66,57 @@ export function validateCoordinates(args, latKey, lonKey) {
         throw new Error(`Both ${latKey} and ${lonKey} must be provided together, or both omitted.`);
     }
 }
+/**
+ * Formats a raw tool response into native MCP content blocks.
+ * Intercepts binary image responses (like Chart Wheels) and returns them as native MCP Images.
+ * Applies a safety limit to JSON payloads to prevent crashing LLM contexts.
+ */
+export function formatToolResponse(toolName, result, durationMs) {
+    // Intercept binary backend responses (like Chart Wheels) to return native MCP Images
+    if (result &&
+        typeof result === "object" &&
+        "encoding" in result &&
+        result.encoding === "base64" &&
+        "data_base64" in result &&
+        "content_type" in result) {
+        const binResp = result;
+        console.error(`[MCP] 🎨 Returning image (${binResp.content_length} bytes) for ${toolName} (${durationMs}ms)`);
+        return {
+            content: [
+                {
+                    type: "image",
+                    data: binResp.data_base64,
+                    mimeType: binResp.content_type,
+                },
+            ],
+        };
+    }
+    const jsonStr = JSON.stringify(result, null, 2);
+    // Safety limit: ~500kb JSON is roughly 100k+ tokens. 
+    // Usually happens if LLMs ask for 50+ years of transits or raw ephemeris arrays.
+    if (jsonStr.length > 500_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,
+        };
+    }
+    console.error(`[MCP] ✅ Success: ${toolName} (${durationMs}ms)`);
+    return {
+        content: [
+            {
+                type: "text",
+                text: jsonStr,
+            },
+        ],
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openephemeris/mcp-server",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "description": "Model Context Protocol server for the Open Ephemeris astronomical computation API",
   "type": "module",
   "main": "dist/index.js",