Satellite Tracking MCP Server

A Model Context Protocol (MCP) server that provides access to satellite tracking data using the N2YO API.

Features

This MCP server provides the following capabilities:

Tools

• get_satellite_position: Get real-time position of a satellite by NORAD ID

• get_satellite_tle: Get TLE (Two-Line Element) data for a satellite by NORAD ID

• predict_visual_passes: Predict visible passes of a satellite over a location

• predict_radio_passes: Predict radio frequency passes of a satellite over a location

• get_satellites_above: Get satellites currently above a specified location

• search_satellites: Search for satellites by name or category

Resources

• satellite://{norad_id}: Information about a satellite by NORAD ID

• satellites://category/{category_id}: List of satellites in a specific category

• satellites://above/{lat}/{lon}/{radius}: List of satellites above a specified location

Installation

Prerequisites

• Node.js 18 or higher

• A N2YO API key (available from N2YO API Services)

Setup

1. Clone this repository or download the source code

2. Install dependencies:

3. Build the server:

Configuration

The server requires a N2YO API key to function. You can provide this through the environment variable N2YO_API_KEY.

MCP Settings Configuration

To use this server with Claude, add it to your MCP settings configuration file:

For Claude Desktop App (macOS)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

For Claude VSCode Extension

Edit ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:

Usage Examples

Once the server is configured and running, you can use it with Claude to access satellite tracking data:

Get Satellite Position

Get Satellite TLE Data

Predict Visual Passes

Search for Satellites

Get Satellites Above Location

Access Satellite Resource

Satellite Categories

The server supports the following satellite categories:

API Key Limitations

The N2YO API has usage limits based on your subscription plan. The free tier allows:

• 1,000 requests per hour

• Basic functionality across all endpoints

Be aware of these limits when using the server to avoid exceeding your quota.

Troubleshooting

• API Key Errors: Ensure your N2YO API key is valid and correctly set in the environment variables.

• Rate Limiting: If you encounter rate limiting errors, the server will automatically retry with exponential backoff, but you may need to wait before making additional requests.

• No Data Found: Some satellites may not have real-time tracking data available, especially older or inactive satellites.

License

This project is licensed under the ISC License.