# 🌌 SpaceOps Satellite Operations MCP Server

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![Protocol](https://img.shields.io/badge/MCP-1.0.0-green.svg)](https://modelcontextprotocol.io)
[![Domain](https://img.shields.io/badge/Domain-Space%20%26%20Satellites-navy.svg)](https://www.isro.gov.in/)

A Model Context Protocol (MCP) server that connects LLM agents to live and simulated satellite subsystems, NOAA space weather telemetry (solar flares and geomagnetic storms), and space debris orbital conjunction analysis.

---

## 🧰 Available MCP Tools

This server exposes **3 tools** over standard I/O (stdio) transport:

### 1. `get_satellite_telemetry`
Retrieves telemetry metrics (altitude, velocity, battery status, solar panel voltage, payload instrument health) for a specific satellite.
* **Parameters**:
  - `name` *(string, required)*: Satellite name (e.g., `"CARTOSAT-3"`, `"NISAR"`, `"INSAT-3DR"`).

### 2. `get_space_weather`
Queries NOAA SWPC for active solar radiation storm scale, radio blackouts index, and geomagnetic storm advisories.

### 3. `calculate_orbit_conjunction`
Evaluates distance proximity between a satellite orbit and trackable space debris telemetry coordinates.
* **Parameters**:
  - `satellite_name` *(string, required)*: Target satellite name.
  - `debris_lat` *(float, required)*: Debris latitude.
  - `debris_lon` *(float, required)*: Debris longitude.
  - `debris_alt` *(float, required)*: Debris altitude in km.

---

## 📦 Installation & Quickstart

```bash
# 1. Setup environment
cd spaceops-mcp-server
python -m venv venv
.\venv\Scripts\activate

# 2. Install package
pip install -e .
```

### Claude Desktop Config
```json
{
  "mcpServers": {
    "spaceops": {
      "command": "D:/Projects/spaceops-mcp-server/venv/Scripts/python.exe",
      "args": [
        "-m",
        "spaceops_mcp.server"
      ]
    }
  }
}
```

---

## 🧪 Testing

```bash
python -m pytest -o pythonpath=src
```