# 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

```bash
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

```bash
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`