astro-mcp

astro-mcp

MCP server for astrological chart calculations. Consumes ephemeris-mcp:get_sky_state via MCP-over-SSE client and exposes calculated astrological data (natal charts, transits, synastry, transit previews) as structured JSON tools.

Quick Start

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
./run.sh

Server listens on port 7016 (configurable via ASTRO_PORT).

Docker

docker compose up --build

Health check: GET http://localhost:7016/health

MCP Endpoint

SSE transport at http://localhost:7016/mcp/sse

Tools

Tool	Description
get_planetary_positions	Planetary positions with zodiac signs, degrees, retrograde flags
calculate_natal_chart	Complete natal chart (planets, houses, aspects, angles)
calculate_transit_chart	Transit chart with natal-to-transit aspects + transit location
calculate_synastry_chart	Relationship chart (interaspects, overlays, composite, davison)
calculate_composite_chart	Composite chart via midpoint method (planets, houses, aspects, angles)
get_transit_preview	Significant transit events for a person over a time range
person_manage	CRUD for persons database (name, nickname, birth datetime/location/place, lat/lon)
list_house_systems	List supported house systems

Dashboard

Person management dashboard at http://localhost:7016/dashboard