Satellite Tracking MCP Server

卫星跟踪 MCP 服务

一个使用 N2YO API 提供卫星跟踪数据访问能力的 Model Context Protocol（MCP）服务。

功能

此 MCP 服务提供以下功能：

工具

• get_satellite_position：通过 NORAD ID 获取卫星的实时位置
• get_satellite_tle：通过 NORAD ID 获取卫星的 TLE（两行轨道根数）数据
• predict_visual_passes：预测卫星经过某个地点上空且可见的时间
• predict_radio_passes：预测卫星经过某个地点上空且可进行无线电通信的时间
• get_satellites_above：获取当前位于指定地点上空的卫星
• search_satellites：按名称或类别搜索卫星

资源

• satellite://{norad_id}：通过 NORAD ID 获取卫星信息
• satellites://category/{category_id}：指定类别中的卫星列表
• satellites://above/{lat}/{lon}/{radius}：指定地点上空的卫星列表

安装

前提条件

• Node.js 18 或更高版本
• N2YO API 密钥（可从 N2YO API 服务获取）

设置

1. 克隆此仓库或下载源代码
2. 安装依赖项：

cd satellite-tracking-server
npm install

3. 构建服务：

npm run build

配置

此服务需要 N2YO API 密钥才能运行。你可以通过环境变量 N2YO_API_KEY 提供密钥。

MCP 设置配置

要将此服务与 Claude 配合使用，请将其添加到 MCP 设置配置文件中：

Claude 桌面应用（macOS）

编辑 ~/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": []
    }
  }
}

Claude VSCode 扩展

编辑 ~/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": []
    }
  }
}

使用示例

配置并运行服务后，你可以通过 Claude 访问卫星跟踪数据：

获取卫星位置

<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>

获取卫星 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>

预测可见过境

<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>

搜索卫星

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

获取地点上空的卫星

<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>

访问卫星资源

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

卫星类别

此服务支持以下卫星类别：

类别 ID	说明
0	全部
1	业余
2	立方星
3	教育
4	工程
5	Galileo
6	GLO-OPS
7	GPS-OPS
8	军事
9	雷达
10	资源
11	SARSAT
12	科学
13	TDRSS
14	气象
15	XM/Sirius
16	Iridium-NEXT
17	Globalstar
18	Intelsat
19	SES
20	Telesat
21	Orbcomm
22	Gorizont
23	Raduga
24	Molniya
25	DMC
26	Argos
27	Planet
28	Spire
29	Starlink
30	OneWeb

API 密钥限制

N2YO API 的使用限额取决于你的订阅方案。免费套餐允许：

• 每小时 1,000 次请求
• 所有端点均可使用基本功能

使用此服务时请留意这些限制，以免超出配额。

故障排除

• API 密钥错误：确保 N2YO API 密钥有效，并已正确设置为环境变量。
• 速率限制：如果遇到速率限制错误，服务会自动采用指数退避策略重试，但你可能需要等待一段时间才能继续发送请求。
• 未找到数据：部分卫星可能没有可用的实时跟踪数据，尤其是较旧或已停止运行的卫星。

许可证

此项目根据 ISC 许可证授权。