@openephemeris/mcp-server 3.13.9 → 3.13.10

package/dist/tools/apps/vedic-chart-app.js

@@ -0,0 +1,226 @@
+/**
+ * vedic-chart-app.ts — MCP App tool registration for the Vedic Jyotish Chart Explorer.
+ *
+ * Registers 1 tool:
+ *   • explore_vedic_chart — primary entry point [model + app visible]
+ *     Calls POST /vedic/chart and returns a data payload + UI resource URI
+ *     so Claude Desktop can render the interactive South Indian Rashi grid.
+ *
+ * Also exports resource helpers (getVedicChartBundle, etc.) for use in
+ * server-sse.ts resource listing and reading.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { registerTool, SERVER_VERSION } from "../index.js";
+import { getActiveClient } from "../../backend/client.js";
+// ── Constants ─────────────────────────────────────────────────────────────────
+export const VEDIC_CHART_RESOURCE_URI = "ui://openephemeris/vedic-chart";
+export const VEDIC_CHART_MIME_TYPE = "text/html;profile=mcp-app";
+const here = path.dirname(fileURLToPath(import.meta.url));
+const BUNDLE_PATHS = [
+    path.resolve(here, "..", "..", "..", "dist", "ui", "vedic-chart.html"),
+];
+function findBundlePath() {
+    for (const p of BUNDLE_PATHS) {
+        if (fs.existsSync(p))
+            return p;
+    }
+    return null;
+}
+let cachedBundle = null;
+/** Read the pre-built HTML bundle. Returns null if not yet built. */
+export function getVedicChartBundle() {
+    if (cachedBundle)
+        return cachedBundle;
+    const bundlePath = findBundlePath();
+    if (!bundlePath)
+        return null;
+    try {
+        cachedBundle = fs.readFileSync(bundlePath, "utf-8");
+        return cachedBundle;
+    }
+    catch {
+        return null;
+    }
+}
+/** Reset cache (useful in dev watch mode or tests). */
+export function clearVedicChartBundleCache() {
+    cachedBundle = null;
+}
+function parseVedicArgs(args) {
+    const { datetime, latitude, longitude, ayanamsa } = args;
+    if (!datetime) {
+        throw new Error("datetime is required. Provide an ISO 8601 datetime in UTC, " +
+            "e.g. datetime='1987-07-15T14:30:00Z'.");
+    }
+    if (latitude == null || longitude == null) {
+        throw new Error("latitude and longitude are required for Vedic chart calculation. " +
+            "Example: latitude=28.6, longitude=77.2 (New Delhi).");
+    }
+    return { datetime, latitude, longitude, ayanamsa: ayanamsa || undefined };
+}
+// ── Summary builder ──────────────────────────────────────────────────────────
+// Convert a sidereal longitude (0–360°) to the Western sign name
+function lonToSignName(lon) {
+    const SIGNS = [
+        "Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo",
+        "Libra", "Scorpio", "Sagittarius", "Capricorn", "Aquarius", "Pisces",
+    ];
+    const idx = Math.floor(((lon % 360) + 360) % 360 / 30) % 12;
+    return SIGNS[idx];
+}
+function buildVedicSummary(data) {
+    const planets = data.planets || [];
+    const metadata = data.metadata || {};
+    // lagna is a degree float from the backend — convert to sign name
+    const lagnaSign = typeof metadata.lagna === "number"
+        ? lonToSignName(metadata.lagna)
+        : metadata.lagna || "unknown";
+    // Backend returns "ayanamsha" (with extra h) — normalise
+    const ayanamsa = metadata.ayanamsa || metadata.ayanamsha || "Lahiri";
+    const ayanamsaVal = metadata.ayanamsa_value != null
+        ? " (" + metadata.ayanamsa_value.toFixed(2) + "°)"
+        : metadata.correction != null
+            ? " (" + metadata.correction.toFixed(2) + "°)"
+            : "";
+    let summary = "**Vedic Jyotish Chart** — Lagna: **" + lagnaSign + "** · Ayanamsa: " +
+        ayanamsa + ayanamsaVal + "\n\n";
+    // Planet placement table
+    if (planets.length > 0) {
+        summary += "| Planet | Rashi | Degree | Nakshatra | Pada |\n";
+        summary += "|--------|-------|--------|-----------|------|\n";
+        for (const p of planets) {
+            const retroMark = p.is_retrograde ? " ℞" : "";
+            summary +=
+                "| " + capFirst(String(p.planet)) + retroMark +
+                    " | " + (p.rashi_western || p.rashi || "?") +
+                    " | " + (typeof p.rashi_degree === "number" ? p.rashi_degree.toFixed(2) + "°" : "?") +
+                    " | " + (p.nakshatra?.name || "?") +
+                    " | " + (p.nakshatra?.pada || "?") +
+                    " |\n";
+        }
+        summary += "\n";
+    }
+    summary += "Click on any Rashi cell to explore the planets placed there.";
+    return summary;
+}
+function capFirst(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+// ── Tool: explore_vedic_chart ─────────────────────────────────────────────────
+registerTool({
+    name: "explore_vedic_chart",
+    description: "Generate an interactive Vedic Jyotish (South Indian) Rashi chart visualization.\n\n" +
+        "Renders a 4×4 fixed-sign grid with:\n" +
+        "  • All nine Jyotish planets (Sun through Ketu) placed in their Rashi\n" +
+        "  • Lagna (Ascendant) cell marked with a gold diagonal\n" +
+        "  • Sanskrit/Devanagari sign labels toggle\n" +
+        "  • Click any Rashi cell → detailed planet info drawer\n" +
+        "    (degree, Nakshatra, Pada, lord, Navamsa sign, dignity)\n" +
+        "  • Ask Claude buttons for Lagna, Moon/Nakshatra, and full chart interpretation\n" +
+        "  • Ayanamsa system displayed (Lahiri by default)\n\n" +
+        "CREDIT COST: 1 credit.\n\n" +
+        "Use this for a rich, interactive Vedic chart experience in MCP Apps-capable hosts " +
+        "(Claude Desktop). Falls back to a markdown table summary in other hosts.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            datetime: {
+                type: "string",
+                description: "Birth date and time as ISO 8601, e.g. '1987-07-15T14:30:00Z'. " +
+                    "Always include time when known — it determines the Lagna (Ascendant).",
+            },
+            latitude: {
+                type: "number",
+                description: "Birth latitude in decimal degrees, e.g. 28.6 for New Delhi.",
+            },
+            longitude: {
+                type: "number",
+                description: "Birth longitude in decimal degrees, e.g. 77.2 for New Delhi.",
+            },
+            ayanamsa: {
+                type: "string",
+                enum: ["lahiri", "fagan_bradley", "krishnamurti", "raman", "yukteshwar"],
+                description: "Ayanamsa system for sidereal calculation. " +
+                    "Options: 'lahiri' (default, most common), 'raman', 'krishnamurti', 'fagan_bradley', 'yukteshwar'.",
+            },
+        },
+        required: ["datetime", "latitude", "longitude"],
+        additionalProperties: false,
+    },
+    annotations: {
+        title: "Interactive Vedic Jyotish Chart",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    _meta: {
+        ui: {
+            resourceUri: VEDIC_CHART_RESOURCE_URI,
+            visibility: ["model", "app"],
+        },
+    },
+    handler: async (args) => {
+        const { datetime, latitude, longitude, ayanamsa } = parseVedicArgs(args);
+        const client = getActiveClient();
+        // Backend field is datetime_utc (matches vedic.ts specialized tool)
+        const body = {
+            datetime_utc: datetime,
+            latitude,
+            longitude,
+        };
+        if (ayanamsa)
+            body.ayanamsa = ayanamsa;
+        const result = await client.request("POST", "/vedic/chart", { data: body });
+        const rawMeta = result.metadata || {};
+        // Backend returns lagna as a degree float (e.g. 213.4) but the iframe
+        // expects a sign name string (e.g. "Scorpio") for cell matching.
+        const lagnaRaw = rawMeta.lagna;
+        const lagnaSign = typeof lagnaRaw === "number"
+            ? lonToSignName(lagnaRaw)
+            : lagnaRaw || "";
+        // Backend returns "ayanamsha" (extra h) — normalise to "ayanamsa".
+        const ayanamsaName = rawMeta.ayanamsa || rawMeta.ayanamsha || "Lahiri";
+        const normalizedMeta = {
+            ...rawMeta,
+            lagna: lagnaSign,
+            ayanamsa: ayanamsaName,
+            // Expose correction as ayanamsa_value so the iframe can show the degree
+            ayanamsa_value: rawMeta.ayanamsa_value ?? rawMeta.correction ?? null,
+        };
+        // Build a Set from the retrograde_planets list the Go handler populated.
+        const retrogradeList = Array.isArray(rawMeta.retrograde_planets)
+            ? rawMeta.retrograde_planets
+            : [];
+        const retrogradeSet = new Set(retrogradeList);
+        const uiPayload = {
+            // Stamp is_retrograde on each planet using the retrograde_planets list
+            // from metadata — the Go struct has no such field, so it lives in metadata.
+            planets: (result.planets || []).map((p) => ({
+                ...p,
+                is_retrograde: retrogradeSet.has(String(p.planet)),
+            })),
+            metadata: normalizedMeta,
+            server_version: SERVER_VERSION,
+        };
+        const summary = buildVedicSummary(uiPayload);
+        const bundleAvailable = Boolean(getVedicChartBundle());
+        if (bundleAvailable) {
+            return {
+                content: [
+                    { type: "text", text: summary },
+                    // Second text block is injected as window.__VEDIC_CHART_DATA__ by ext-apps SDK
+                    { type: "text", text: JSON.stringify(uiPayload) },
+                ],
+                _meta: {
+                    "ui/resourceUri": VEDIC_CHART_RESOURCE_URI,
+                    ui: { resourceUri: VEDIC_CHART_RESOURCE_URI },
+                },
+            };
+        }
+        // Fallback: text-only table
+        return { content: [{ type: "text", text: summary }] };
+    },
+});

package/dist/tools/index.js

@@ -74,6 +74,10 @@ export async function initTools(profile) {
         await import("./apps/chart-wheel-app.js");
         await import("./apps/bodygraph-app.js");
         await import("./apps/bi-wheel-app.js");
+        await import("./apps/transit-timeline-app.js");
+        await import("./apps/moon-phase-app.js");
+        await import("./apps/bazi-app.js");
+        await import("./apps/vedic-chart-app.js");
         await import("./apps/location-tools.js");
     }
 }

package/dist/tools/specialized/acg.js

@@ -54,7 +54,7 @@ registerTool({
         required: ["birth_datetime", "birth_latitude", "birth_longitude"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Astrocartography Lines", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime", "birth_latitude", "birth_longitude"]);
         const body = {
@@ -147,7 +147,7 @@ registerTool({
         required: ["birth_datetime", "birth_latitude", "birth_longitude", "query_latitude", "query_longitude"],
         additionalProperties: false,
     },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Astrocartography Location Hits", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime", "birth_latitude", "birth_longitude", "query_latitude", "query_longitude"]);
         const body = {