kundali-chart-mcp 0.2.1

package/kundali-chart-mcp.js

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+
+/**
+ * Kundali MCP Server — Vedic astrology chart generation.
+ *
+ * Usage:
+ *   kundali-chart-mcp <function-url>
+ *   kundali-chart-mcp https://kundali-mcp-func.azurewebsites.net
+ *
+ * If no URL is provided, uses KUNDALI_FUNCTION_URL env var
+ * or falls back to the default hosted instance.
+ */
+
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
+import { execSync } from "node:child_process";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// ─── Install dependencies if needed ────────────────────────────────────────
+const nodeModules = join(__dirname, "node_modules");
+if (!existsSync(nodeModules)) {
+  console.error("📦 Installing dependencies (first run)...");
+  try {
+    execSync("npm install", { cwd: __dirname, stdio: "inherit" });
+  } catch (e) {
+    console.error("❌ Failed to install dependencies. Run manually:");
+    console.error(`   cd ${__dirname} && npm install`);
+    process.exit(1);
+  }
+}
+
+// ─── Load MCP SDK ──────────────────────────────────────────────────────────
+const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
+const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+const { z } = await import("zod");
+
+// ─── Config ────────────────────────────────────────────────────────────────
+const DEFAULT_URL = "https://kundali-mcp-func.azurewebsites.net";
+const FUNCTION_URL = process.argv[2] || process.env.KUNDALI_FUNCTION_URL || DEFAULT_URL;
+
+if (!FUNCTION_URL) {
+  console.error("Usage: kundali-chart-mcp <function-url>");
+  console.error("   or: KUNDALI_FUNCTION_URL=<url> kundali-chart-mcp");
+  process.exit(1);
+}
+
+// ─── HTTP helper ───────────────────────────────────────────────────────────
+async function callRemote(toolName, payload) {
+  let url = `${FUNCTION_URL}/api/kundali/${toolName}`;
+  if (process.env.KUNDALI_FUNCTION_KEY) {
+    url += `?code=${process.env.KUNDALI_FUNCTION_KEY}`;
+  }
+
+  const res = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(payload),
+  });
+
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(`HTTP ${res.status}: ${body}`);
+  }
+
+  return res.json();
+}
+
+// ─── Helpers ───────────────────────────────────────────────────────────────
+function jsonContent(data) {
+  return {
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+  };
+}
+
+const standardBirthInput = {
+  name: z.string().optional().describe("Person's name."),
+  city: z.string().optional().describe("Birth city. Used for geocoding if coordinates not provided."),
+  date_of_birth: z.string().describe("Birth date YYYY-MM-DD."),
+  time_of_birth: z.string().describe("Birth time HH:MM or HH:MM:SS, local to birthplace."),
+  latitude: z.number().optional().describe("Birth latitude. Must come with longitude."),
+  longitude: z.number().optional().describe("Birth longitude. Must come with latitude."),
+  timezone: z.string().optional().describe("IANA timezone, e.g. Asia/Kolkata."),
+  ayanamsa_mode: z.string().optional().describe("Ayanamsa, default 'lahiri'."),
+  house_system: z.string().optional().describe("House system code, default 'P'."),
+};
+
+// ─── Server ────────────────────────────────────────────────────────────────
+const server = new McpServer({
+  name: "kundali-chart",
+  version: "0.2.0",
+});
+
+server.tool("generate_kundali", "Generate a Vedic Kundali birth chart from birth details.", {
+  name: z.string().describe("Person's name."),
+  city: z.string().describe("Birth city/place."),
+  date_of_birth: z.string().describe("Birth date in YYYY-MM-DD format."),
+  time_of_birth: z.string().describe("Birth time in HH:MM or HH:MM:SS format."),
+  latitude: z.number().optional(),
+  longitude: z.number().optional(),
+  timezone: z.string().optional(),
+  chart_type: z.string().optional().describe("Optional chart type. Default: lagna."),
+  ayanamsa_mode: z.string().optional().describe("Optional sidereal mode. Default: lahiri."),
+  house_system: z.string().optional().describe("Optional house system code. Default: P."),
+}, async (args) => jsonContent(await callRemote("generate_kundali", args)));
+
+server.tool("list_available_chart_types", "List supported Kundali chart types and aliases.", {}, async (a) => jsonContent(await callRemote("list_available_chart_types", a)));
+server.tool("list_ayanamsa_modes", "List all sidereal (ayanamsa) modes.", {}, async (a) => jsonContent(await callRemote("list_ayanamsa_modes", a)));
+server.tool("list_house_systems", "List all house systems.", {}, async (a) => jsonContent(await callRemote("list_house_systems", a)));
+server.tool("search_birth_places", "Search birth-place suggestions.", { query: z.string(), limit: z.number().int().min(1).max(10).optional() }, async (a) => jsonContent(await callRemote("search_birth_places", a)));
+server.tool("get_timezone_for_coordinates", "Get IANA timezone for lat/lon.", { latitude: z.number(), longitude: z.number() }, async (a) => jsonContent(await callRemote("get_timezone_for_coordinates", a)));
+server.tool("get_transit_positions", "Get sidereal planetary transit positions.", { datetime_utc: z.string().optional() }, async (a) => jsonContent(await callRemote("get_transit_positions", a)));
+server.tool("get_extended_chart", "Get enhanced Kundali chart with SubLord/KP data.", { year: z.number(), month: z.number(), day: z.number(), hour: z.number(), minute: z.number(), second: z.number().optional(), utc_offset: z.string(), latitude: z.number(), longitude: z.number(), ayanamsa: z.string().optional(), house_system: z.string().optional() }, async (a) => jsonContent(await callRemote("get_extended_chart", a)));
+server.tool("get_vimshottari_dasha", "Get Vimshottari Dasha periods.", { year: z.number(), month: z.number(), day: z.number(), hour: z.number(), minute: z.number(), second: z.number().optional(), utc_offset: z.string(), latitude: z.number(), longitude: z.number(), ayanamsa: z.string().optional(), house_system: z.string().optional() }, async (a) => jsonContent(await callRemote("get_vimshottari_dasha", a)));
+server.tool("get_planetary_aspects", "Get all planetary aspects.", { year: z.number(), month: z.number(), day: z.number(), hour: z.number(), minute: z.number(), second: z.number().optional(), utc_offset: z.string(), latitude: z.number(), longitude: z.number(), ayanamsa: z.string().optional(), house_system: z.string().optional() }, async (a) => jsonContent(await callRemote("get_planetary_aspects", a)));
+server.tool("get_significators", "Get planet-wise and house-wise significators (KP system).", { year: z.number(), month: z.number(), day: z.number(), hour: z.number(), minute: z.number(), second: z.number().optional(), utc_offset: z.string(), latitude: z.number(), longitude: z.number(), ayanamsa: z.string().optional(), house_system: z.string().optional() }, async (a) => jsonContent(await callRemote("get_significators", a)));
+server.tool("list_extended_options", "List supported ayanamsas and house systems for extended tools.", {}, async (a) => jsonContent(await callRemote("list_extended_options", a)));
+server.tool("get_panchanga", "Get Panchanga (5 Vedic time limbs) for any datetime and location.", { datetime: z.string().optional(), timezone: z.string().optional(), ayanamsa_mode: z.string().optional() }, async (a) => jsonContent(await callRemote("get_panchanga", a)));
+server.tool("get_doshas", "Check all major doshas: Mangal Dosha, Kaal Sarp Dosha, Sade Sati, Graha Yuddha, Combustion.", { ...standardBirthInput, current_saturn_rashi: z.string().optional() }, async (a) => jsonContent(await callRemote("get_doshas", a)));
+server.tool("get_yogas", "Identify all major Vedic Yogas.", standardBirthInput, async (a) => jsonContent(await callRemote("get_yogas", a)));
+server.tool("get_compatibility", "Ashtakoot Milan: 36-point Vedic marriage compatibility scoring.", { chart1: z.object(standardBirthInput), chart2: z.object(standardBirthInput) }, async (a) => jsonContent(await callRemote("get_compatibility", a)));
+server.tool("get_special_conditions", "Check Vargottama, Pushkara Navamsha, Dig Bala, Jaimini Karakas.", standardBirthInput, async (a) => jsonContent(await callRemote("get_special_conditions", a)));
+server.tool("get_pratyantar_dasha", "Get 3-level Vimshottari Dasha: MD → AD → PD.", standardBirthInput, async (a) => jsonContent(await callRemote("get_pratyantar_dasha", a)));
+server.tool("get_yogini_dasha", "Get Yogini Dasha (8-yogini, 36-year cycle).", standardBirthInput, async (a) => jsonContent(await callRemote("get_yogini_dasha", a)));
+server.tool("get_varshaphal", "Get Varshaphal (Solar Return chart).", { ...standardBirthInput, year_of_life: z.number(), query_latitude: z.number().optional(), query_longitude: z.number().optional(), query_timezone: z.string().optional() }, async (a) => jsonContent(await callRemote("get_varshaphal", a)));
+server.tool("get_ashtakavarga", "Get Ashtakavarga benefic point scores.", standardBirthInput, async (a) => jsonContent(await callRemote("get_ashtakavarga", a)));
+server.tool("get_shadbala", "Get Shadbala — six-fold planetary strength.", standardBirthInput, async (a) => jsonContent(await callRemote("get_shadbala", a)));
+server.tool("get_jaimini", "Get full Jaimini astrology: Chara Karakas, aspects, Karakamsha.", standardBirthInput, async (a) => jsonContent(await callRemote("get_jaimini", a)));
+server.tool("get_muhurta", "Score a datetime for Muhurta (auspicious timing).", { datetime: z.string().optional(), timezone: z.string().optional(), event_type: z.string().optional() }, async (a) => jsonContent(await callRemote("get_muhurta", a)));
+server.tool("get_best_muhurta", "Find top 5 auspicious Muhurta windows in a date range.", { start_datetime: z.string(), end_datetime: z.string(), timezone: z.string().optional(), latitude: z.number().optional(), longitude: z.number().optional(), event_type: z.string().optional() }, async (a) => jsonContent(await callRemote("get_best_muhurta", a)));
+server.tool("get_avasthas", "Get planetary Avasthas (9 states + Baladi Avasthas).", standardBirthInput, async (a) => jsonContent(await callRemote("get_avasthas", a)));
+server.tool("get_upagrahas", "Get Upagrahas (shadow sub-planets): Gulika, Mandi, Dhuma, etc.", standardBirthInput, async (a) => jsonContent(await callRemote("get_upagrahas", a)));
+server.tool("get_gandanta", "Check Gandanta zones (water-fire junctions).", standardBirthInput, async (a) => jsonContent(await callRemote("get_gandanta", a)));
+server.tool("get_kartari", "Check Kartari Yoga (hemmed between benefics/malefics).", standardBirthInput, async (a) => jsonContent(await callRemote("get_kartari", a)));
+server.tool("get_nakshatra_analysis", "Get deep Nakshatra information for each planet.", { ...standardBirthInput, nakshatra_name: z.string().optional() }, async (a) => jsonContent(await callRemote("get_nakshatra_analysis", a)));
+server.tool("get_gochara", "Get Gochara (Vedic transit analysis).", { ...standardBirthInput, transit_datetime: z.string().optional() }, async (a) => jsonContent(await callRemote("get_gochara", a)));
+server.tool("get_bhava_chalit", "Get Bhava Chalit chart (actual house positions).", standardBirthInput, async (a) => jsonContent(await callRemote("get_bhava_chalit", a)));
+server.tool("get_hora", "Get Planetary Hour (Hora) for datetime and location.", { datetime: z.string().optional(), timezone: z.string().optional(), latitude: z.number().optional(), longitude: z.number().optional() }, async (a) => jsonContent(await callRemote("get_hora", a)));
+server.tool("get_sudarshana_chakra", "Get Sudarshana Chakra triple-layer chart analysis.", standardBirthInput, async (a) => jsonContent(await callRemote("get_sudarshana_chakra", a)));
+server.tool("get_ashtottari_dasha", "Get Ashtottari Dasha (108-year, 8-planet cycle).", standardBirthInput, async (a) => jsonContent(await callRemote("get_ashtottari_dasha", a)));
+server.tool("get_sookshma_dasha", "Get Sookshma Dasha (4th level of Vimshottari).", standardBirthInput, async (a) => jsonContent(await callRemote("get_sookshma_dasha", a)));
+server.tool("get_prana_dasha", "Get Prana Dasha (5th level of Vimshottari).", standardBirthInput, async (a) => jsonContent(await callRemote("get_prana_dasha", a)));
+server.tool("get_char_dasha", "Get Char Dasha (Jaimini).", standardBirthInput, async (a) => jsonContent(await callRemote("get_char_dasha", a)));
+server.tool("get_narayana_dasha", "Get Narayana Dasha (Jaimini).", standardBirthInput, async (a) => jsonContent(await callRemote("get_narayana_dasha", a)));
+server.tool("get_tajaka", "Get Tajaka analysis for Varshaphal.", { ...standardBirthInput, year_of_life: z.number(), query_latitude: z.number().optional(), query_longitude: z.number().optional(), query_timezone: z.string().optional() }, async (a) => jsonContent(await callRemote("get_tajaka", a)));
+server.tool("get_nabhasha_yogas", "Get Nabhasha Yogas (Ashrayas, Dala, Akriti).", standardBirthInput, async (a) => jsonContent(await callRemote("get_nabhasha_yogas", a)));
+server.tool("get_arishta", "Get Arishta Yogas (longevity assessment).", standardBirthInput, async (a) => jsonContent(await callRemote("get_arishta", a)));
+server.tool("get_lunar_return", "Get Lunar Return (Chandraphal).", { ...standardBirthInput, target_year: z.number(), target_month: z.number(), query_latitude: z.number().optional(), query_longitude: z.number().optional(), query_timezone: z.string().optional() }, async (a) => jsonContent(await callRemote("get_lunar_return", a)));
+server.tool("get_prasna", "Get Prasna (Horary/Question) chart.", { datetime: z.string().optional(), timezone: z.string().optional(), latitude: z.number().optional(), longitude: z.number().optional(), question: z.string().optional() }, async (a) => jsonContent(await callRemote("get_prasna", a)));
+server.tool("get_kalachakra_dasha", "Get Kalachakra Dasha (9-group, 112-year sign-based dasha).", standardBirthInput, async (a) => jsonContent(await callRemote("get_kalachakra_dasha", a)));
+server.tool("get_kurmachakra", "Get Kurmachakra directional analysis.", { ...standardBirthInput, current_moon_nakshatra: z.string().optional(), event_type: z.enum(["travel", "construction", "marriage", "general"]).optional() }, async (a) => jsonContent(await callRemote("get_kurmachakra", a)));
+server.tool("get_travel_direction_score", "Score a specific travel direction for auspiciousness.", { ...standardBirthInput, intended_direction: z.string(), current_moon_nakshatra: z.string().optional(), weekday: z.enum(["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"]).optional() }, async (a) => jsonContent(await callRemote("get_travel_direction_score", a)));
+server.tool("get_full_kurmachakra_chart", "Return the full Kurmachakra reference chart (all 9 directions).", {}, async (a) => jsonContent(await callRemote("get_full_kurmachakra_chart", a)));
+
+// ─── Start ─────────────────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);