# astronomy-mcp-server

MCP Server for astronomy data — ISS tracking, moon phases, NASA APOD, near-Earth objects, exoplanets, space weather, and upcoming events. **No API key required.**

[![PyPI version](https://badge.fury.io/py/astronomy-mcp-server.svg)](https://badge.fury.io/py/astronomy-mcp-server)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Tools (8)

| Tool | Description |
|------|-------------|
| `tool_get_moon_phase` | Current moon phase, illumination %, next full/new moon |
| `tool_track_iss` | ISS real-time position, altitude, speed, crew aboard |
| `tool_get_astronomy_picture_of_day` | NASA APOD — daily astronomy image with explanation |
| `tool_get_near_earth_objects` | Upcoming asteroid/comet approaches (NASA NeoWs) |
| `tool_get_sunrise_sunset` | Sunrise, sunset, solar noon, twilight for any location |
| `tool_get_space_weather` | Kp-index, solar wind, aurora alerts (NOAA SWPC) |
| `tool_search_exoplanets` | Search 5800+ confirmed exoplanets (NASA Exoplanet Archive) |
| `tool_get_upcoming_events` | Meteor showers, eclipses, solstices, moon phases |

## Data Sources

- **NASA APOD** — api.nasa.gov (DEMO_KEY, 30 req/hour)
- **Open Notify** — api.open-notify.org (ISS position + astronauts, free)
- **NASA NeoWs** — Near Earth Object Web Service (DEMO_KEY)
- **NASA Exoplanet Archive** — exoplanetarchive.ipac.caltech.edu (free TAP API)
- **Sunrise-Sunset.org** — Free sunrise/sunset API
- **NOAA SWPC** — Space Weather Prediction Center (free)
- **Moon phases** — Calculated locally (no API needed)

## Installation

```bash
pip install astronomy-mcp-server
```

## Claude Desktop Configuration

```json
{
  "mcpServers": {
    "astronomy": {
      "command": "astronomy-mcp-server"
    }
  }
}
```

## Example Usage

```
"What is today's moon phase?"
→ tool_get_moon_phase()

"Where is the ISS right now?"
→ tool_track_iss()

"Show me today's NASA astronomy picture"
→ tool_get_astronomy_picture_of_day()

"Are there any asteroids approaching Earth this week?"
→ tool_get_near_earth_objects()

"When does the sun rise in Berlin tomorrow?"
→ tool_get_sunrise_sunset(latitude=52.52, longitude=13.405)

"What is the current space weather / Kp-index?"
→ tool_get_space_weather()

"Find exoplanets similar in size to Earth"
→ tool_search_exoplanets(min_radius=0.8, max_radius=1.5)

"What astronomical events are coming up in May 2026?"
→ tool_get_upcoming_events(year=2026, month=5)
```

## License

MIT — AiAgentKarl