@openephemeris/mcp-server 3.13.5 → 3.13.7

package/dist/index.js

@@ -6,6 +6,7 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { initTools, toolRegistry, formatToolResponse, modelVisibleTools } from "./tools/index.js";
+import { listPrompts, getPromptContent } from "./prompts.js";
 import { CHART_WHEEL_RESOURCE_URI, CHART_WHEEL_MIME_TYPE, getChartWheelBundle, } from "./tools/apps/chart-wheel-app.js";
 import { BODYGRAPH_RESOURCE_URI, BODYGRAPH_MIME_TYPE, getBodygraphBundle, } from "./tools/apps/bodygraph-app.js";
 import { BI_WHEEL_RESOURCE_URI, BI_WHEEL_MIME_TYPE, getBiWheelBundle, } from "./tools/apps/bi-wheel-app.js";
@@ -38,6 +39,9 @@ const server = new Server({
         tools: {},
         prompts: {},
         resources: {},
+        experimental: {
+            "io.modelcontextprotocol/ui": {},
+        },
     },
 });
 // List available tools
@@ -47,53 +51,27 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             name: tool.name,
             description: tool.description,
             inputSchema: tool.inputSchema,
-            annotations: tool.annotations ?? {
-                title: tool.name,
-                readOnlyHint: true,
-                destructiveHint: false,
-            },
         })),
     };
 });
 // 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.",
-            }
-        ]
-    };
+    return { prompts: listPrompts() };
 });
 // Get prompt content
 server.setRequestHandler(GetPromptRequestSchema, async (request) => {
-    if (request.params.name !== "welcome_to_open_ephemeris") {
+    const prompt = getPromptContent(request.params.name);
+    if (!prompt) {
         throw new Error(`Unknown prompt: ${request.params.name}`);
     }
     return {
-        description: "Open Ephemeris Agent Orientation",
+        description: prompt.description,
         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 ephemeris data (1550–2650 CE). 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!"
-                }
-            }
-        ]
+                content: { type: "text", text: prompt.text },
+            },
+        ],
     };
 });
 // List available resources

package/dist/prompts.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Open Ephemeris MCP — Preloaded Prompt Library
+ *
+ * Each prompt is a complete agent workflow that:
+ *   1. Coaches the agent to collect all required data from the user
+ *   2. Handles timezone, coordinate, and house-system nuances correctly
+ *   3. Specifies which tools to call and in what order
+ *   4. Provides a structured interpretation framework
+ */
+export interface McpPrompt {
+    name: string;
+    description: string;
+    text: string;
+}
+export declare const PROMPTS: McpPrompt[];
+/**
+ * Returns the list of all prompts (name + description only, for ListPrompts).
+ */
+export declare function listPrompts(): Array<{
+    name: string;
+    description: string;
+}>;
+/**
+ * Returns the full prompt content for a given prompt name, or null if not found.
+ */
+export declare function getPromptContent(name: string): McpPrompt | null;