kundali-chart-mcp 0.2.1

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "kundali-chart-mcp",
+  "version": "0.2.1",
+  "description": "MCP server for Vedic Kundali chart generation (Azure Function backend).",
+  "type": "module",
+  "bin": {
+    "kundali-chart-mcp": "kundali-chart-mcp.js",
+    "kundali-chart-mcp-setup": "setup.sh"
+  },
+  "files": [
+    "kundali-chart-mcp.js",
+    "setup.sh",
+    "remote-server.js",
+    "index.js",
+    "kundali_bridge.py",
+    "requirements.txt",
+    "python/",
+    "azure-function/"
+  ],
+  "scripts": {
+    "start": "node ./kundali-chart-mcp.js",
+    "start:local": "node ./index.js",
+    "install:python-deps": "python3 -m pip install -r requirements.txt"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.8"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "kundali",
+    "vedic",
+    "astrology",
+    "chart",
+    "azure-function"
+  ],
+  "license": "MIT"
+}

package/python/kundali_lib/__init__.py

@@ -0,0 +1 @@
+"""Standalone Kundali calculation library bundled with the MCP server."""

package/python/kundali_lib/ephemeris.py

@@ -0,0 +1,30 @@
+"""Ephemeris service: thin wrapper over vedic chart."""
+
+from datetime import datetime
+
+from kundali_lib.vedic.chart import build_chart
+
+
+class EphemerisService:
+    """Service for Vedic chart calculation using Swiss Ephemeris."""
+
+    def calculate_chart(
+        self,
+        name: str,
+        birth_datetime: datetime,
+        latitude: float,
+        longitude: float,
+        timezone: str,
+        ayanamsa_mode: str | None = None,
+        house_system: str | None = None,
+    ) -> dict:
+        """Calculate complete birth chart (sidereal, default Lahiri, Placidus)."""
+        return build_chart(
+            name,
+            birth_datetime,
+            latitude,
+            longitude,
+            timezone,
+            ayanamsa_mode=ayanamsa_mode,
+            house_system=house_system,
+        )

package/python/kundali_lib/geocoder.py

@@ -0,0 +1,82 @@
+from geopy.geocoders import Nominatim
+from geopy.extra.rate_limiter import RateLimiter
+from timezonefinder import TimezoneFinder
+from typing import Optional, Tuple, List
+
+
+class GeocoderService:
+    """Service for geocoding city names and getting timezone"""
+
+    def __init__(self):
+        self.geolocator = Nominatim(user_agent="kundali_app")
+        # Nominatim allows 1 request per second; RateLimiter enforces that
+        self._geocode_search = RateLimiter(self.geolocator.geocode, min_delay_seconds=1.0)
+        self.tf = TimezoneFinder()
+
+    def search_cities(self, query: str, limit: int = 8) -> List[dict]:
+        """Search for city/place suggestions using geopy. Returns list of {display_name, name, lat, lon}."""
+        q = (query or "").strip()
+        if len(q) < 2:
+            return []
+        try:
+            # geopy Nominatim: exactly_one=False returns a list, limit caps results
+            locations = self._geocode_search(q, exactly_one=False, limit=limit, timeout=10)
+            if not locations:
+                return []
+            results = []
+            for loc in locations:
+                display_name = loc.address or ""
+                raw = getattr(loc, "raw", None) or {}
+                addr = raw.get("address", {}) or {}
+                name = (
+                    addr.get("city")
+                    or addr.get("town")
+                    or addr.get("village")
+                    or addr.get("municipality")
+                    or addr.get("county")
+                    or addr.get("state")
+                    or (display_name.split(",")[0].strip() if display_name else "")
+                )
+                results.append({
+                    "display_name": display_name,
+                    "name": name,
+                    "lat": float(loc.latitude),
+                    "lon": float(loc.longitude),
+                })
+            return results
+        except Exception:
+            return []
+    
+    def get_city_coordinates(self, city: str) -> Optional[Tuple[float, float]]:
+        """Get latitude and longitude for a city"""
+        try:
+            location = self.geolocator.geocode(city)
+            if location:
+                return (location.latitude, location.longitude)
+            return None
+        except Exception:
+            return None
+    
+    def get_timezone(self, latitude: float, longitude: float) -> Optional[str]:
+        """Get timezone from coordinates"""
+        try:
+            timezone_str = self.tf.timezone_at(lat=latitude, lng=longitude)
+            return timezone_str
+        except Exception:
+            return None
+    
+    def get_city_info(self, city: str) -> Optional[dict]:
+        """Get complete city information including coordinates and timezone"""
+        coords = self.get_city_coordinates(city)
+        if not coords:
+            return None
+        
+        latitude, longitude = coords
+        timezone = self.get_timezone(latitude, longitude)
+        
+        return {
+            'city': city,
+            'latitude': latitude,
+            'longitude': longitude,
+            'timezone': timezone or 'UTC'
+        }

package/python/kundali_lib/vedic/__init__.py

@@ -0,0 +1 @@
+"""Vedic astrology calculation helpers."""