git clone https://github.com/AiAgentKarl/space-mcp-server.git
cd space-mcp-server
python -m venv .venv
.venv/Scripts/activate  # Windows
# source .venv/bin/activate  # Linux/Mac
pip install -e .

cp .env.example .env
# Edit .env and add your NASA API key (optional, DEMO_KEY works out of the box)

space-mcp
# or
python -m src.server

{
  "mcpServers": {
    "space": {
      "type": "stdio",
      "command": "path/to/.venv/Scripts/python.exe",
      "args": ["-m", "src.server"],
      "env": {
        "NASA_API_KEY": "your-api-key-here"
      }
    }
  }
}

src/
├── server.py          # FastMCP server entry point
├── config.py          # Settings & environment variables
├── analytics.py       # Usage tracking
├── clients/
│   ├── nasa.py        # NASA API (APOD, Mars, NeoWs, DONKI)
│   ├── epic.py        # EPIC Earth imagery
│   ├── eonet.py       # EONET natural events
│   ├── nasa_images.py # NASA Image Library
│   └── exoplanet.py   # Exoplanet Archive
└── tools/
    ├── astronomy.py   # APOD, image search, exoplanets, space weather
    ├── mars.py        # Mars rover photos & info
    ├── asteroids.py   # Near-Earth objects & asteroid details
    └── earth.py       # EPIC imagery & natural events