Servidor MCP de seguimiento satelital

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a datos de seguimiento satelital mediante la API N2YO.

Características

Este servidor MCP proporciona las siguientes capacidades:

Herramientas

get_satellite_position : obtiene la posición en tiempo real de un satélite mediante el ID de NORAD
get_satellite_tle : Obtener datos TLE (elemento de dos líneas) para un satélite por ID de NORAD
predict_visual_passes : Predice los pases visibles de un satélite sobre una ubicación
predict_radio_passes : Predice los pases de radiofrecuencia de un satélite sobre una ubicación
get_satellites_above : Obtener los satélites que se encuentran actualmente sobre una ubicación específica
search_satellites : Busca satélites por nombre o categoría

Recursos

satélite://{norad_id} : Información sobre un satélite por ID de NORAD
satélites://categoría/{category_id} : Lista de satélites en una categoría específica
satélites://arriba/{lat}/{lon}/{radio} : Lista de satélites sobre una ubicación específica

Instalación

Prerrequisitos

Node.js 18 o superior
Una clave API de N2YO (disponible en los Servicios de API de N2YO )

Configuración

Clona este repositorio o descarga el código fuente
Instalar dependencias:

cd satellite-tracking-server
npm install

Construir el servidor:

npm run build

Configuración

El servidor requiere una clave API de N2YO para funcionar. Puede proporcionarla mediante la variable de entorno N2YO_API_KEY .

Configuración de ajustes de MCP

Para utilizar este servidor con Claude, agréguelo a su archivo de configuración de MCP:

Para la aplicación de escritorio de Claude (macOS)

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

{
  "mcpServers": {
    "satellite-tracking": {
      "command": "node",
      "args": ["/path/to/satellite-tracking-server/build/index.js"],
      "env": {
        "N2YO_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Para la extensión VSCode de Claude

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

{
  "mcpServers": {
    "satellite-tracking": {
      "command": "node",
      "args": ["/path/to/satellite-tracking-server/build/index.js"],
      "env": {
        "N2YO_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Ejemplos de uso

Una vez que el servidor esté configurado y funcionando, puedes usarlo con Claude para acceder a los datos de seguimiento satelital:

Obtener la posición del satélite

<use_mcp_tool>
<server_name>satellite-tracking</server_name>
<tool_name>get_satellite_position</tool_name>
<arguments>
{
  "norad_id": 25544,
  "observer_lat": 40.7128,
  "observer_lng": -74.0060
}
</arguments>
</use_mcp_tool>

Obtener datos satelitales TLE

<use_mcp_tool>
<server_name>satellite-tracking</server_name>
<tool_name>get_satellite_tle</tool_name>
<arguments>
{
  "norad_id": 25544
}
</arguments>
</use_mcp_tool>

Predecir pases visuales

<use_mcp_tool>
<server_name>satellite-tracking</server_name>
<tool_name>predict_visual_passes</tool_name>
<arguments>
{
  "norad_id": 25544,
  "observer_lat": 40.7128,
  "observer_lng": -74.0060,
  "days": 7
}
</arguments>
</use_mcp_tool>

Búsqueda de satélites

<use_mcp_tool>
<server_name>satellite-tracking</server_name>
<tool_name>search_satellites</tool_name>
<arguments>
{
  "query": "ISS"
}
</arguments>
</use_mcp_tool>

Obtener satélites por encima de la ubicación

<use_mcp_tool>
<server_name>satellite-tracking</server_name>
<tool_name>get_satellites_above</tool_name>
<arguments>
{
  "observer_lat": 40.7128,
  "observer_lng": -74.0060,
  "search_radius": 45
}
</arguments>
</use_mcp_tool>

Recurso satelital de acceso

<access_mcp_resource>
<server_name>satellite-tracking</server_name>
<uri>satellite://25544</uri>
</access_mcp_resource>

Categorías de satélites

El servidor admite las siguientes categorías de satélites:

Identificación de categoría	Descripción
0	Todo
1	Aficionado
2	CubeSat
3	Educación
4	Ingeniería
5	Galileo
6	GLO-OPS
7	GPS-OPS
8	Militar
9	Radar
10	Recurso
11	SARSAT
12	Ciencia
13	TDRSS
14	Clima
15	XM/Sirius
16	Iridium-NEXT
17	Estrella global
18	Intelsat
19	SES
20	Telesat
21	Orbcomm
22	Gorizont
23	Raduga
24	Molniya
25	DMC
26	Argos
27	Planeta
28	Aguja
29	Starlink
30	OneWeb

Limitaciones de la clave API

La API de N2YO tiene límites de uso según tu plan de suscripción. El plan gratuito permite:

1.000 solicitudes por hora
Funcionalidad básica en todos los puntos finales

Tenga en cuenta estos límites al utilizar el servidor para evitar exceder su cuota.

Solución de problemas

Errores de clave API : asegúrese de que su clave API N2YO sea válida y esté configurada correctamente en las variables de entorno.
Limitación de velocidad : si encuentra errores de limitación de velocidad, el servidor volverá a intentarlo automáticamente con una reducción exponencial, pero es posible que deba esperar antes de realizar solicitudes adicionales.
No se encontraron datos : es posible que algunos satélites no tengan datos de seguimiento en tiempo real disponibles, especialmente los satélites más antiguos o inactivos.

Licencia

Este proyecto está licenciado bajo la licencia ISC.

Satellite Tracking MCP Server

Integrations