kundali-chart-mcp 0.2.1

package/remote-server.js

@@ -0,0 +1,590 @@
+#!/usr/bin/env node
+
+/**
+ * Remote MCP server for Kundali chart generation.
+ * Proxies tool calls to an Azure Function backend.
+ *
+ * Usage:
+ *   npx kundali-chart-mcp <function-url> [function-key]
+ *
+ * Example:
+ *   npx kundali-chart-mcp https://kundali-mcp-func.azurewebsites.net
+ *
+ * Or set environment variables:
+ *   KUNDALI_FUNCTION_URL=https://kundali-mcp-func.azurewebsites.net
+ *   KUNDALI_FUNCTION_KEY=<optional-key>
+ */
+
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const FUNCTION_URL = process.argv[2] || process.env.KUNDALI_FUNCTION_URL;
+const FUNCTION_KEY = process.argv[3] || process.env.KUNDALI_FUNCTION_KEY;
+
+if (!FUNCTION_URL) {
+  console.error(
+    "Usage: npx kundali-chart-mcp <function-url> [function-key]\n" +
+      "   or: KUNDALI_FUNCTION_URL=<url> npx kundali-chart-mcp\n\n" +
+      "Get a free function URL at: https://github.com/your-repo/kundali-chart-mcp",
+  );
+  process.exit(1);
+}
+
+async function callRemote(toolName, payload) {
+  let url = `${FUNCTION_URL}/api/kundali/${toolName}`;
+  if (FUNCTION_KEY) {
+    url += `?code=${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();
+}
+
+const server = new McpServer({
+  name: "kundali-chart",
+  version: "0.2.0",
+});
+
+function jsonContent(data) {
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(data, null, 2),
+      },
+    ],
+  };
+}
+
+// ─── Tool definitions ──────────────────────────────────────────────────────
+
+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.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().describe("Optional birthplace latitude."),
+    longitude: z.number().optional().describe("Optional birthplace longitude."),
+    timezone: z.string().optional().describe("Optional IANA timezone."),
+    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 (args) =>
+    jsonContent(await callRemote("list_available_chart_types", args)),
+);
+
+server.tool(
+  "list_ayanamsa_modes",
+  "List all sidereal (ayanamsa) modes.",
+  {},
+  async (args) => jsonContent(await callRemote("list_ayanamsa_modes", args)),
+);
+
+server.tool("list_house_systems", "List all house systems.", {}, async (args) =>
+  jsonContent(await callRemote("list_house_systems", args)),
+);
+
+server.tool(
+  "search_birth_places",
+  "Search birth-place suggestions.",
+  {
+    query: z.string().describe("Place/city search text."),
+    limit: z.number().int().min(1).max(10).optional(),
+  },
+  async (args) => jsonContent(await callRemote("search_birth_places", args)),
+);
+
+server.tool(
+  "get_timezone_for_coordinates",
+  "Get IANA timezone for lat/lon.",
+  { latitude: z.number(), longitude: z.number() },
+  async (args) =>
+    jsonContent(await callRemote("get_timezone_for_coordinates", args)),
+);
+
+server.tool(
+  "get_transit_positions",
+  "Get sidereal planetary transit positions.",
+  {
+    datetime_utc: z
+      .string()
+      .optional()
+      .describe("ISO UTC datetime. Defaults to now."),
+  },
+  async (args) => jsonContent(await callRemote("get_transit_positions", args)),
+);
+
+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 (args) => jsonContent(await callRemote("get_extended_chart", args)),
+);
+
+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 (args) => jsonContent(await callRemote("get_vimshottari_dasha", args)),
+);
+
+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 (args) => jsonContent(await callRemote("get_planetary_aspects", args)),
+);
+
+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 (args) => jsonContent(await callRemote("get_significators", args)),
+);
+
+server.tool(
+  "list_extended_options",
+  "List supported ayanamsas and house systems for extended tools.",
+  {},
+  async (args) => jsonContent(await callRemote("list_extended_options", args)),
+);
+
+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 (args) => jsonContent(await callRemote("get_panchanga", args)),
+);
+
+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 (args) => jsonContent(await callRemote("get_doshas", args)),
+);
+
+server.tool(
+  "get_yogas",
+  "Identify all major Vedic Yogas.",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_yogas", args)),
+);
+
+server.tool(
+  "get_compatibility",
+  "Ashtakoot Milan: 36-point Vedic marriage compatibility scoring.",
+  {
+    chart1: z.object(standardBirthInput),
+    chart2: z.object(standardBirthInput),
+  },
+  async (args) => jsonContent(await callRemote("get_compatibility", args)),
+);
+
+server.tool(
+  "get_special_conditions",
+  "Check Vargottama, Pushkara Navamsha, Dig Bala, Jaimini Karakas.",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_special_conditions", args)),
+);
+
+server.tool(
+  "get_pratyantar_dasha",
+  "Get 3-level Vimshottari Dasha: MD → AD → PD.",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_pratyantar_dasha", args)),
+);
+
+server.tool(
+  "get_yogini_dasha",
+  "Get Yogini Dasha (8-yogini, 36-year cycle).",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_yogini_dasha", args)),
+);
+
+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 (args) => jsonContent(await callRemote("get_varshaphal", args)),
+);
+
+server.tool(
+  "get_ashtakavarga",
+  "Get Ashtakavarga benefic point scores.",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_ashtakavarga", args)),
+);
+
+server.tool(
+  "get_shadbala",
+  "Get Shadbala — six-fold planetary strength.",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_shadbala", args)),
+);
+
+server.tool(
+  "get_jaimini",
+  "Get full Jaimini astrology: Chara Karakas, aspects, Karakamsha.",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_jaimini", args)),
+);
+
+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 (args) => jsonContent(await callRemote("get_muhurta", args)),
+);
+
+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 (args) => jsonContent(await callRemote("get_best_muhurta", args)),
+);
+
+server.tool(
+  "get_avasthas",
+  "Get planetary Avasthas (9 states + Baladi Avasthas).",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_avasthas", args)),
+);
+
+server.tool(
+  "get_upagrahas",
+  "Get Upagrahas (shadow sub-planets): Gulika, Mandi, Dhuma, etc.",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_upagrahas", args)),
+);
+
+server.tool(
+  "get_gandanta",
+  "Check Gandanta zones (water-fire junctions).",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_gandanta", args)),
+);
+
+server.tool(
+  "get_kartari",
+  "Check Kartari Yoga (hemmed between benefics/malefics).",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_kartari", args)),
+);
+
+server.tool(
+  "get_nakshatra_analysis",
+  "Get deep Nakshatra information for each planet.",
+  { ...standardBirthInput, nakshatra_name: z.string().optional() },
+  async (args) => jsonContent(await callRemote("get_nakshatra_analysis", args)),
+);
+
+server.tool(
+  "get_gochara",
+  "Get Gochara (Vedic transit analysis).",
+  { ...standardBirthInput, transit_datetime: z.string().optional() },
+  async (args) => jsonContent(await callRemote("get_gochara", args)),
+);
+
+server.tool(
+  "get_bhava_chalit",
+  "Get Bhava Chalit chart (actual house positions).",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_bhava_chalit", args)),
+);
+
+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 (args) => jsonContent(await callRemote("get_hora", args)),
+);
+
+server.tool(
+  "get_sudarshana_chakra",
+  "Get Sudarshana Chakra triple-layer chart analysis.",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_sudarshana_chakra", args)),
+);
+
+server.tool(
+  "get_ashtottari_dasha",
+  "Get Ashtottari Dasha (108-year, 8-planet cycle).",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_ashtottari_dasha", args)),
+);
+
+server.tool(
+  "get_sookshma_dasha",
+  "Get Sookshma Dasha (4th level of Vimshottari).",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_sookshma_dasha", args)),
+);
+
+server.tool(
+  "get_prana_dasha",
+  "Get Prana Dasha (5th level of Vimshottari).",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_prana_dasha", args)),
+);
+
+server.tool(
+  "get_char_dasha",
+  "Get Char Dasha (Jaimini).",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_char_dasha", args)),
+);
+
+server.tool(
+  "get_narayana_dasha",
+  "Get Narayana Dasha (Jaimini).",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_narayana_dasha", args)),
+);
+
+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 (args) => jsonContent(await callRemote("get_tajaka", args)),
+);
+
+server.tool(
+  "get_nabhasha_yogas",
+  "Get Nabhasha Yogas (Ashrayas, Dala, Akriti).",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_nabhasha_yogas", args)),
+);
+
+server.tool(
+  "get_arishta",
+  "Get Arishta Yogas (longevity assessment).",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_arishta", args)),
+);
+
+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 (args) => jsonContent(await callRemote("get_lunar_return", args)),
+);
+
+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 (args) => jsonContent(await callRemote("get_prasna", args)),
+);
+
+server.tool(
+  "get_kalachakra_dasha",
+  "Get Kalachakra Dasha (9-group, 112-year sign-based dasha).",
+  standardBirthInput,
+  async (args) => jsonContent(await callRemote("get_kalachakra_dasha", args)),
+);
+
+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 (args) => jsonContent(await callRemote("get_kurmachakra", args)),
+);
+
+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 (args) =>
+    jsonContent(await callRemote("get_travel_direction_score", args)),
+);
+
+server.tool(
+  "get_full_kurmachakra_chart",
+  "Return the full Kurmachakra reference chart (all 9 directions).",
+  {},
+  async (args) =>
+    jsonContent(await callRemote("get_full_kurmachakra_chart", args)),
+);
+
+// ─── Start server ──────────────────────────────────────────────────────────
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/requirements.txt

@@ -0,0 +1,8 @@
+# Python dependencies for the bundled Kundali calculation bridge.
+# This intentionally excludes llama-cpp-python and other local-LLM/chat dependencies.
+pyswisseph==2.10.3.1
+timezonefinder
+geopy==2.4.1
+pytz
+certifi>=2024.2.0
+vedicastro