Satellite Anomaly

NitroStack MCP TypeScript License: MIT

An onboard Model Context Protocol (MCP) server built with NitroStack for autonomous satellite constellation telemetry classification, South Atlantic Anomaly (SAA) radiation glitch filtering, and safety envelope arbitration.

Designed for seamless deployment on NitroCloud and direct integration with ChatGPT, Claude, and Nitro Studio.

---

🛰️ Architecture & Capabilities

                  Telemetry Vector Stream
                            │
                            ▼
          ┌───────────────────────────────────┐
          │  Stage 1: Hard Safety Envelope    │ ──► Trip? ──► SAFE_MODE
          └───────────────────────────────────┘
                            │ (No)
                            ▼
          ┌───────────────────────────────────┐
          │  Stage 2: Space Weather Filter   │ ──► SAA & SEU Glitch? ──► CONTINUE_MISSION
          └───────────────────────────────────┘
                            │ (No)
                            ▼
          ┌───────────────────────────────────┐
          │  Stage 3: Sensor Fault Isolation  │ ──► Gyro Drift? ──► ISOLATE_SENSOR
          └───────────────────────────────────┘
                            │ (Nominal)
                            ▼
                     NOMINAL OPERATING MODE

Core MCP Modules (src/modules/)

Module	Description	MCP Tools / Operations
telemetry	Multi-stage safety envelope & threshold evaluator	evaluate_telemetry
anomaly	Fault scenario simulator & density novelty detector	simulate_scenario, detect_novelty_anomaly
alerts	Component isolation & spacecraft emergency safing	isolate_fault_component, trigger_safe_mode
reports	Structured diagnostic summary for flight controllers	generate_diagnostic_report
auth	Ground station security & permission verifier	verify_ground_station_auth

---

📦 MCP Resources & Prompts

Resources

• telemetry://current-state - Latest real-time spacecraft telemetry vector.
• telemetry://safety-thresholds - Configured hardware limits (voltage, thermal, tumbling).
• satellite://constellation-health - Health matrix across active constellation satellites.

Prompts

• triage_fault - Guided flight ops prompt for evaluating anomalies and recommending recovery.
• generate_pass_summary - Ground station contact pass summary prompt.

---

🚀 Quick Start

1. Installation

git clone https://github.com/Litheshan07/satellite-anomaly-mcp.git
cd satellite-anomaly-mcp
npm install

2. Build & Test

# Build TypeScript
npm run build

# Run automated test suite
npm test

3. Development in Nitro Studio

# Run NitroStack dev server
npx @nitrostack/cli dev

Open Nitro Studio, select Add Server, choose Nitro Project, and select this directory.

---

☁️ Deployment

Deploying to NitroCloud

1. Open Nitro Studio.
2. Click Deploy in the top right corner.
3. Select NitroCloud.
4. Copy the production MCP URL and add it as an Action / MCP server in ChatGPT Custom GPTs.

Alternative Cloud Deploy via CLI

# Create optimized production package
npx @nitrostack/cli pack

---

🛡️ License

This project is licensed under the MIT License - see the LICENSE file for details.