How anhadlamba30/librejyotish works
LibreJyotish is a stateless Vedic-astrology MCP server: a client supplies a tool request and receives structured calculations with conventions and warnings. Its domain stages include birth-chart and divisional-chart calculation, timing and transit analysis, panchang, and specialized strength, aspect, Jaimini, eclipse, and Saturn-period results; offline geocoding supports location input. The server dispatches requests to calculation modules, which share Swiss Ephemeris primitives and bundled data. Edges reflect README documentation and SOURCE INDEX references; unsampled server wiring is not inferred beyond those references.
Main entry points: server.py Tool server · ephemeris.py Ephemeris engine · constants.py Astrology constants · charts.py Natal and divisional charts
Components 18
MCP interface
- Tool server
librejyotish/server.py - Batch runner
librejyotish/server.py
Chart calculations
- Natal and divisional charts
librejyotish/core/charts.py - Graha aspects
librejyotish/core/drishti.py - Ashtakavarga
librejyotish/core/ashtakavarga.py - Shadbala
librejyotish/core/shadbala.py - Jaimini padas
librejyotish/core/jaimini.py
Timing and almanac
- Vimshottari dasha
librejyotish/core/dasha.py - Panchang
librejyotish/core/panchang.py - Current transits
librejyotish/server.py - Eclipses
librejyotish/core/eclipses.py - Saturn periods
librejyotish/core/saturn_periods.py
Shared foundations
- Offline geocoder
librejyotish/core/geocode.py - Ephemeris engine
librejyotish/core/ephemeris.py - Bundled ephemeris
librejyotish/data/ephe - City gazetteer
librejyotish/data/gazetteer/cities.csv - Astrology constants
librejyotish/core/constants.py
Other components
- MCP client
Connections 35
- MCP client → Tool server: requests tools
README.md - Tool server → Natal and divisional charts: dispatches chart tools
librejyotish/server.py - Tool server → Vimshottari dasha: dispatches dasha
librejyotish/server.py - Tool server → Panchang: dispatches panchang
librejyotish/server.py - Tool server → Ashtakavarga: dispatches analysis
librejyotish/server.py - Tool server → Shadbala: dispatches analysis
librejyotish/server.py - Tool server → Jaimini padas: dispatches padas
librejyotish/server.py - Tool server → Eclipses: dispatches eclipse queries
librejyotish/server.py - Tool server → Saturn periods: dispatches period queries
librejyotish/server.py - Tool server → Offline geocoder: dispatches lookup
librejyotish/server.py - Tool server → Current transits: serves transit tool
README.md - Tool server → Batch runner: runs batch operations
librejyotish/server.py - Batch runner → Tool server: calls selected tool
librejyotish/server.py - Natal and divisional charts → Ephemeris engine: calculates positions
librejyotish/core/charts.py - Natal and divisional charts → Graha aspects: uses aspects
librejyotish/core/charts.py - Vimshottari dasha → Ephemeris engine: reads birth positions
librejyotish/core/dasha.py - Panchang → Ephemeris engine: computes sky positions
librejyotish/core/panchang.py - Ashtakavarga → Ephemeris engine: reads positions
librejyotish/core/ashtakavarga.py - Jaimini padas → Natal and divisional charts: uses chart results
librejyotish/core/jaimini.py - Jaimini padas → Ephemeris engine: uses positions
librejyotish/core/jaimini.py - Saturn periods → Natal and divisional charts: gets natal Moon
librejyotish/core/saturn_periods.py - Saturn periods → Ephemeris engine: scans Saturn
librejyotish/core/saturn_periods.py - Shadbala → Natal and divisional charts: uses chart data
librejyotish/core/shadbala.py - Shadbala → Ephemeris engine: uses sky positions
librejyotish/core/shadbala.py - Eclipses → Ephemeris engine: calculates events
librejyotish/core/eclipses.py - Ephemeris engine → Bundled ephemeris: reads files
README.md - Offline geocoder → City gazetteer: searches cities
README.md - Ephemeris engine → Astrology constants: uses shared values
librejyotish/core/ephemeris.py - Natal and divisional charts → Astrology constants: uses shared values
librejyotish/core/charts.py - Vimshottari dasha → Astrology constants: uses shared values
librejyotish/core/dasha.py - Panchang → Astrology constants: uses shared values
librejyotish/core/panchang.py - Ashtakavarga → Astrology constants: uses shared values
librejyotish/core/ashtakavarga.py - Jaimini padas → Astrology constants: uses shared values
librejyotish/core/jaimini.py - Saturn periods → Astrology constants: uses shared values
librejyotish/core/saturn_periods.py - Shadbala → Astrology constants: uses shared values
librejyotish/core/shadbala.py