@openephemeris/mcp-server 3.12.0 → 3.13.0

package/README.md

@@ -355,8 +355,8 @@ Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live
 
 - Allowlisted operations: **28**
 - Methods: `GET=4`, `POST=24`, `PUT=0`, `PATCH=0`, `DELETE=0`
-- Registered tools (`OPENEPHEMERIS_PROFILE=dev`): **57**
-- Typed tools: `acg_hits`, `acg_power_lines`, `auth_login`, `auth_logout`, `auth_status`, `chart_wheel_on_aspect_click`, `chart_wheel_on_house_click`, `chart_wheel_on_planet_click`, `chart_wheel_recalculate`, `chinese_bazi`, `dev_call`, `dev_list_allowed`, `electional_aspect_search`, `electional_moment_analysis`, `electional_station_tracker`, `ephemeris_angles_points`, `ephemeris_aspect_check`, `ephemeris_bi_wheel`, `ephemeris_chart_wheel`, `ephemeris_composite`, `ephemeris_composite_midpoint`, `ephemeris_dignities`, `ephemeris_electional`, `ephemeris_fixed_stars`, `ephemeris_hermetic_lots`, `ephemeris_house_cusps`, `ephemeris_lunar_return`, `ephemeris_midpoints`, `ephemeris_moon_phase`, `ephemeris_natal_batch`, `ephemeris_natal_chart`, `ephemeris_natal_transits`, `ephemeris_next_eclipse`, `ephemeris_next_lunar_phase`, `ephemeris_overlay`, `ephemeris_planet_position`, `ephemeris_planetary_return`, `ephemeris_progressed_chart`, `ephemeris_relocation`, `ephemeris_retrograde_status`, `ephemeris_solar_return`, `ephemeris_synastry`, `ephemeris_transits`, `explore_natal_chart`, `hd_opposition`, `hd_planetary_return`, `human_design_bodygraph`, `human_design_chart`, `human_design_composite`, `human_design_penta`, `vedic_chart`, `venus_eight_year_star`, `venus_elongations`, `venus_phase`, `venus_star_points`, `venus_star_points_conjunctions`, `venus_stations`
+- Registered tools (`OPENEPHEMERIS_PROFILE=dev`): **64**
+- Typed tools: `acg_hits`, `acg_power_lines`, `auth_login`, `auth_logout`, `auth_status`, `bi_wheel_on_cross_aspect_click`, `bi_wheel_on_planet_click`, `chart_wheel_on_aspect_click`, `chart_wheel_on_house_click`, `chart_wheel_on_planet_click`, `chart_wheel_recalculate`, `chinese_bazi`, `dev_call`, `dev_list_allowed`, `electional_aspect_search`, `electional_moment_analysis`, `electional_station_tracker`, `ephemeris_angles_points`, `ephemeris_aspect_check`, `ephemeris_bi_wheel`, `ephemeris_chart_wheel`, `ephemeris_composite`, `ephemeris_composite_midpoint`, `ephemeris_dignities`, `ephemeris_electional`, `ephemeris_fixed_stars`, `ephemeris_hermetic_lots`, `ephemeris_house_cusps`, `ephemeris_lunar_return`, `ephemeris_midpoints`, `ephemeris_moon_phase`, `ephemeris_natal_batch`, `ephemeris_natal_chart`, `ephemeris_natal_transits`, `ephemeris_next_eclipse`, `ephemeris_next_lunar_phase`, `ephemeris_overlay`, `ephemeris_planet_position`, `ephemeris_planetary_return`, `ephemeris_progressed_chart`, `ephemeris_relocation`, `ephemeris_retrograde_status`, `ephemeris_solar_return`, `ephemeris_synastry`, `ephemeris_transits`, `explore_bi_wheel`, `explore_human_design`, `explore_natal_chart`, `hd_on_center_click`, `hd_on_channel_click`, `hd_on_gate_click`, `hd_opposition`, `hd_planetary_return`, `human_design_bodygraph`, `human_design_chart`, `human_design_composite`, `human_design_penta`, `vedic_chart`, `venus_eight_year_star`, `venus_elongations`, `venus_phase`, `venus_star_points`, `venus_star_points_conjunctions`, `venus_stations`
 - Generic tools: 
 
 ### Allowlist Families

package/dist/index.js

@@ -7,6 +7,8 @@ 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 { 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";
 function resolveServerVersion() {
     try {
         const here = path.dirname(fileURLToPath(import.meta.url));
@@ -96,38 +98,55 @@ server.setRequestHandler(GetPromptRequestSchema, async (request) => {
 });
 // List available resources
 server.setRequestHandler(ListResourcesRequestSchema, async () => {
-    const bundle = getChartWheelBundle();
-    if (!bundle)
-        return { resources: [] };
-    return {
-        resources: [
-            {
-                uri: CHART_WHEEL_RESOURCE_URI,
-                name: "Chart Wheel Explorer",
-                description: "Interactive natal chart wheel with clickable planets, houses, and aspects.",
-                mimeType: CHART_WHEEL_MIME_TYPE,
-            },
-        ],
-    };
+    const resources = [];
+    if (getChartWheelBundle()) {
+        resources.push({
+            uri: CHART_WHEEL_RESOURCE_URI,
+            name: "Chart Wheel Explorer",
+            description: "Interactive natal chart wheel with clickable planets, houses, and aspects.",
+            mimeType: CHART_WHEEL_MIME_TYPE,
+        });
+    }
+    if (getBodygraphBundle()) {
+        resources.push({
+            uri: BODYGRAPH_RESOURCE_URI,
+            name: "Human Design Bodygraph Explorer",
+            description: "Interactive Human Design Bodygraph with clickable centers, gates, and channels.",
+            mimeType: BODYGRAPH_MIME_TYPE,
+        });
+    }
+    if (getBiWheelBundle()) {
+        resources.push({
+            uri: BI_WHEEL_RESOURCE_URI,
+            name: "Bi-Wheel Explorer",
+            description: "Interactive synastry or transit bi-wheel with cross-aspect lines and clickable planets.",
+            mimeType: BI_WHEEL_MIME_TYPE,
+        });
+    }
+    return { resources };
 });
 // Read resource
 server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-    if (request.params.uri !== CHART_WHEEL_RESOURCE_URI) {
-        throw new Error(`Unknown resource: ${request.params.uri}`);
+    const uri = request.params.uri;
+    if (uri === CHART_WHEEL_RESOURCE_URI) {
+        const bundle = getChartWheelBundle();
+        if (!bundle)
+            throw new Error("Chart Wheel UI bundle not found. Run `npm run build:ui` to build it.");
+        return { contents: [{ uri: CHART_WHEEL_RESOURCE_URI, mimeType: CHART_WHEEL_MIME_TYPE, text: bundle }] };
     }
-    const bundle = getChartWheelBundle();
-    if (!bundle) {
-        throw new Error("Chart Wheel UI bundle not found. Run `npm run build:ui` to build it.");
+    if (uri === BODYGRAPH_RESOURCE_URI) {
+        const bundle = getBodygraphBundle();
+        if (!bundle)
+            throw new Error("Bodygraph UI bundle not found. Run `npm run build:ui` to build it.");
+        return { contents: [{ uri: BODYGRAPH_RESOURCE_URI, mimeType: BODYGRAPH_MIME_TYPE, text: bundle }] };
     }
-    return {
-        contents: [
-            {
-                uri: CHART_WHEEL_RESOURCE_URI,
-                mimeType: CHART_WHEEL_MIME_TYPE,
-                text: bundle,
-            },
-        ],
-    };
+    if (uri === BI_WHEEL_RESOURCE_URI) {
+        const bundle = getBiWheelBundle();
+        if (!bundle)
+            throw new Error("Bi-Wheel UI bundle not found. Run `npm run build:ui` to build it.");
+        return { contents: [{ uri: BI_WHEEL_RESOURCE_URI, mimeType: BI_WHEEL_MIME_TYPE, text: bundle }] };
+    }
+    throw new Error(`Unknown resource: ${uri}`);
 });
 // Handle tool calls
 server.setRequestHandler(CallToolRequestSchema, async (request) => {

package/dist/server-sse.js

@@ -25,6 +25,8 @@ import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema
 import { initTools, toolRegistry, formatToolResponse, modelVisibleTools } from "./tools/index.js";
 import { BackendClient, runWithClient } from "./backend/client.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";
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -243,37 +245,54 @@ function createMcpServer() {
     });
     // --- Resource handlers ---
     server.setRequestHandler(ListResourcesRequestSchema, async () => {
-        const bundle = getChartWheelBundle();
-        if (!bundle)
-            return { resources: [] };
-        return {
-            resources: [
-                {
-                    uri: CHART_WHEEL_RESOURCE_URI,
-                    name: "Chart Wheel Explorer",
-                    description: "Interactive natal chart wheel with clickable planets, houses, and aspects.",
-                    mimeType: CHART_WHEEL_MIME_TYPE,
-                },
-            ],
-        };
+        const resources = [];
+        if (getChartWheelBundle()) {
+            resources.push({
+                uri: CHART_WHEEL_RESOURCE_URI,
+                name: "Chart Wheel Explorer",
+                description: "Interactive natal chart wheel with clickable planets, houses, and aspects.",
+                mimeType: CHART_WHEEL_MIME_TYPE,
+            });
+        }
+        if (getBodygraphBundle()) {
+            resources.push({
+                uri: BODYGRAPH_RESOURCE_URI,
+                name: "Human Design Bodygraph Explorer",
+                description: "Interactive Human Design Bodygraph with clickable centers, gates, and channels.",
+                mimeType: BODYGRAPH_MIME_TYPE,
+            });
+        }
+        if (getBiWheelBundle()) {
+            resources.push({
+                uri: BI_WHEEL_RESOURCE_URI,
+                name: "Bi-Wheel Explorer",
+                description: "Interactive synastry or transit bi-wheel with cross-aspect lines and clickable planets.",
+                mimeType: BI_WHEEL_MIME_TYPE,
+            });
+        }
+        return { resources };
     });
     server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-        if (request.params.uri !== CHART_WHEEL_RESOURCE_URI) {
-            throw new Error(`Unknown resource: ${request.params.uri}`);
+        const uri = request.params.uri;
+        if (uri === CHART_WHEEL_RESOURCE_URI) {
+            const bundle = getChartWheelBundle();
+            if (!bundle)
+                throw new Error("Chart Wheel UI bundle not found. Run `npm run build:ui` to build it.");
+            return { contents: [{ uri: CHART_WHEEL_RESOURCE_URI, mimeType: CHART_WHEEL_MIME_TYPE, text: bundle }] };
         }
-        const bundle = getChartWheelBundle();
-        if (!bundle) {
-            throw new Error("Chart Wheel UI bundle not found. Run `npm run build:ui` to build it.");
+        if (uri === BODYGRAPH_RESOURCE_URI) {
+            const bundle = getBodygraphBundle();
+            if (!bundle)
+                throw new Error("Bodygraph UI bundle not found. Run `npm run build:ui` to build it.");
+            return { contents: [{ uri: BODYGRAPH_RESOURCE_URI, mimeType: BODYGRAPH_MIME_TYPE, text: bundle }] };
         }
-        return {
-            contents: [
-                {
-                    uri: CHART_WHEEL_RESOURCE_URI,
-                    mimeType: CHART_WHEEL_MIME_TYPE,
-                    text: bundle,
-                },
-            ],
-        };
+        if (uri === BI_WHEEL_RESOURCE_URI) {
+            const bundle = getBiWheelBundle();
+            if (!bundle)
+                throw new Error("Bi-Wheel UI bundle not found. Run `npm run build:ui` to build it.");
+            return { contents: [{ uri: BI_WHEEL_RESOURCE_URI, mimeType: BI_WHEEL_MIME_TYPE, text: bundle }] };
+        }
+        throw new Error(`Unknown resource: ${uri}`);
     });
     return server;
 }

package/dist/tools/apps/bi-wheel-app.d.ts

@@ -0,0 +1,38 @@
+/**
+ * bi-wheel-app.ts — MCP App tool registration for the Bi-Wheel Explorer.
+ *
+ * Registers 3 tools:
+ *   • explore_bi_wheel               — primary entry point: fetches two charts, computes
+ *                                      cross-aspects, returns data + UI resource [model]
+ *   • bi_wheel_on_cross_aspect_click — cross-aspect click handler [app-only]
+ *   • bi_wheel_on_planet_click       — planet click handler (inner or outer wheel) [app-only]
+ *
+ * Modes:
+ *   synastry — fetch two natal charts in parallel (person1 inner, person2 outer)
+ *   transit  — fetch one natal chart (inner) + one transit chart (outer)
+ *
+ * Cross-aspects are computed client-side (UI) AND server-side (for summary/fallback).
+ * The payload cross_aspects array is capped at 30 tightest-orb aspects.
+ */
+export declare const BI_WHEEL_RESOURCE_URI = "ui://openephemeris/bi-wheel";
+export declare const BI_WHEEL_MIME_TYPE = "text/html;profile=mcp-app";
+/** Read the pre-built HTML bundle. Returns null if not yet built. */
+export declare function getBiWheelBundle(): string | null;
+export declare function clearBiWheelBundleCache(): void;
+interface PlanetPoint {
+    name: string;
+    longitude: number;
+    speed?: number;
+}
+interface CrossAspect {
+    planet1: string;
+    wheel1: "inner" | "outer";
+    planet2: string;
+    wheel2: "inner" | "outer";
+    type: string;
+    angle: number;
+    orb: number;
+    applying: boolean;
+}
+export declare function computeCrossAspects(planets1: PlanetPoint[], planets2: PlanetPoint[]): CrossAspect[];
+export {};