N2YO Satellite Tracker MCP Server

A Model Context Protocol (MCP) server that provides access to N2YO satellite tracking data, including TLE (Two-Line Element) data, satellite positions, and pass predictions.

Overview

This MCP server integrates with the N2YO.com API to provide satellite tracking capabilities. N2YO is a real-time satellite tracking service that offers comprehensive data on satellites, including military, weather, GPS, amateur radio, and commercial satellites.

Key Features

- Natural Language Queries: Ask questions like "What satellites will be over France at 6:00 tonight?"
- TLE Data Access: Get Two-Line Element data for any satellite by NORAD ID
- Category-based Search: Find satellites by type (military, weather, GPS, etc.)
- Country Filtering: Filter satellites by country or organization
- Real-time Positioning: Get current satellite positions relative to observer
- Pass Predictions: Predict when satellites will be visible from your location
- Overhead Tracking: Find all satellites currently above a specific location
- ⭐ Radio Pass Optimization: Communication windows for amateur radio operators
- ⭐ Satellite Name Search: Find satellites by name instead of NORAD ID
- ⭐ Recent Launch Tracking: Monitor newly deployed satellites
- ⭐ Space Debris Monitoring: Track debris for collision avoidance
- ⭐ Trajectory Visualization: Get satellite paths over time

Installation

git clone <repository-url>
cd n2yo-satellite-tracker-mcp
npm install
npm run build

Setup

1. Get N2YO API Key: Register at N2YO.com and generate an API key from your profile
2. Configure the server:
- Option A (Recommended): Set environment variable N2YO_API_KEY=your-api-key
- Option B: Use the set_n2yo_api_key tool to configure your API key during runtime
3. Start tracking: Use the various tools to track satellites

Usage

```bash