@openephemeris/mcp-server 3.9.3 → 3.10.2

package/CHANGELOG.md

@@ -7,8 +7,41 @@ Version numbering follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [3.10.0] — 2026-04-23
+
+### Added
+- **Native visual rendering (Tier 1 MCP App)** — `ephemeris_natal_chart`, `ephemeris_synastry`,
+  `human_design_chart`, `ephemeris_progressed_chart`, and `ephemeris_solar_return` now accept
+  `include_visual: true` to embed a live chart image directly in the conversation alongside
+  the JSON data. A single tool call returns both interpretation data and a rendered chart.
+- **`visual_config` parameter** — optional `{ theme, size }` object on all visual-capable data
+  tools. Astrology charts default to `theme: "light"`, HD bodygraphs default to `theme: "dark"`
+  (per HD convention). Size range 200–4000 px, default 800.
+- **Dual-content response handler** — `formatToolResponse` in `tools/index.ts` now intercepts
+  embedded `VisualResult` objects: base64-encodes raw SVG strings on the fly, emits an MCP image
+  block (`{ type: "image" }`) first, then a clean JSON text block with the `visual` key stripped.
+  PNG payloads (already base64 from the sidecar) are passed through without double-encoding.
+- **`test/visual-rendering.test.ts`** — 26 new unit tests covering the full visual pipeline:
+  SVG encoding, PNG passthrough, dual-block output, key stripping, standalone binary passthrough,
+  plain JSON fallthrough, and defensive handling of incomplete `visual` keys.
+
+### Changed
+- `ephemeris_chart_wheel`, `ephemeris_bi_wheel`, and `human_design_bodygraph` (standalone
+  visualization tools) now **default to SVG** instead of PNG. This eliminates the `resvg` binary
+  dependency that caused runtime environment mismatches in Docker/Fly deployments. PNG remains
+  available as an explicit opt-in via `format: "png"`.
+- Tool descriptions for standalone visual tools updated to reflect SVG-first rendering.
+
+### Fixed
+- Chart render failures caused by `resvg` binary not being available in the Node.js MCP
+  server runtime environment. SVG is now rendered natively by the Go sidecar with no external
+  binary dependencies.
+
+---
+
 ## [3.9.0] — 2026-04-22
 
+
 ### Added
 - **Streamable HTTP transport** (`POST/GET/DELETE /mcp`) — implements the MCP 2025-11-25
   specification. New integrations (Smithery, cursor, Claude Web) should prefer

package/README.md

@@ -355,8 +355,8 @@ Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live
 
 - Allowlisted operations: **23**
 - Methods: `GET=4`, `POST=19`, `PUT=0`, `PATCH=0`, `DELETE=0`
-- Registered tools (`OPENEPHEMERIS_PROFILE=dev`): **52**
-- Typed tools: `acg_hits`, `acg_power_lines`, `auth_login`, `auth_logout`, `auth_status`, `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`, `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`): **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`
 - Generic tools: 
 
 ### Allowlist Families

package/config/dev-allowlist.json

@@ -391,14 +391,6 @@
       ],
       "operationId": "reverse_geocode_location_reverse_get"
     },
-    {
-      "method": "GET",
-      "path": "/tidal/forcing/deep-time",
-      "tags": [
-        "tidal"
-      ],
-      "operationId": "get_tidal_forcing_deep_time_endpoint_tidal_forcing_deep_time_get"
-    },
     {
       "method": "GET",
       "path": "/tidal/forcing",

package/dist/index.js

@@ -4,8 +4,9 @@ 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, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { initTools, toolRegistry, formatToolResponse } from "./tools/index.js";
+import { CHART_WHEEL_RESOURCE_URI, CHART_WHEEL_MIME_TYPE, getChartWheelBundle, } from "./tools/apps/chart-wheel-app.js";
 function resolveServerVersion() {
     try {
         const here = path.dirname(fileURLToPath(import.meta.url));
@@ -34,6 +35,7 @@ const server = new Server({
     capabilities: {
         tools: {},
         prompts: {},
+        resources: {},
     },
 });
 // List available tools
@@ -92,6 +94,41 @@ 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,
+            },
+        ],
+    };
+});
+// Read resource
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    if (request.params.uri !== CHART_WHEEL_RESOURCE_URI) {
+        throw new Error(`Unknown resource: ${request.params.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,
+            },
+        ],
+    };
+});
 // Handle tool calls
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const toolName = request.params.name;

package/dist/server-sse.js

@@ -21,9 +21,10 @@ import axios from "axios";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, isInitializeRequest, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, isInitializeRequest, } from "@modelcontextprotocol/sdk/types.js";
 import { initTools, toolRegistry, formatToolResponse } 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";
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -184,7 +185,7 @@ function createMcpServer() {
                 "and more — powered by JPL DE440 ephemerides for sub-arcsecond accuracy.",
         },
     }, {
-        capabilities: { tools: {}, prompts: {} },
+        capabilities: { tools: {}, prompts: {}, resources: {} },
         instructions: "Open Ephemeris is a precision astronomical computation engine. " +
             "Use format='llm' on any tool for compact, token-efficient output. " +
             "All computations use JPL DE440 ephemerides for sub-arcsecond accuracy. " +
@@ -240,6 +241,40 @@ 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,
+                },
+            ],
+        };
+    });
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        if (request.params.uri !== CHART_WHEEL_RESOURCE_URI) {
+            throw new Error(`Unknown resource: ${request.params.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,
+                },
+            ],
+        };
+    });
     return server;
 }
 const httpSessions = new Map();

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

@@ -0,0 +1,19 @@
+/**
+ * chart-wheel-app.ts — MCP App tool registration for the Chart Wheel Explorer.
+ *
+ * Registers 5 tools:
+ *   • explore_natal_chart         — primary entry point, returns data + UI resource
+ *   • chart_wheel_on_planet_click — event handler for planet clicks
+ *   • chart_wheel_on_house_click  — event handler for house clicks
+ *   • chart_wheel_on_aspect_click — event handler for aspect clicks
+ *   • chart_wheel_recalculate     — recalculates with a different house system
+ *
+ * Also exports resource helpers (getChartWheelBundle, etc.) for use in
+ * index.ts and server-sse.ts.
+ */
+export declare const CHART_WHEEL_RESOURCE_URI = "ui://openephemeris/chart-wheel";
+export declare const CHART_WHEEL_MIME_TYPE = "text/html;profile=mcp-app";
+/** Read the pre-built HTML bundle. Returns null if not yet built. */
+export declare function getChartWheelBundle(): string | null;
+/** Reset cache (useful in dev watch mode or tests). */
+export declare function clearBundleCache(): void;