卫星跟踪 MCP 服务器

模型上下文协议 (MCP) 服务器使用 N2YO API 提供对卫星跟踪数据的访问。

特征

该 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 服务获取）

设置

克隆此存储库或下载源代码
安装依赖项：

cd satellite-tracking-server
npm install

构建服务器：

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	伽利略
6	环球行动
7	GPS操作
8	军队
9	雷达
10	资源
11	萨斯卫星
12	科学
十三	时域雷达辅助系统
14	天气
15	XM/天狼星
16	铱星NEXT
17	全球星
18	国际通信卫星组织
19	SES
20	电信卫星公司
21	轨道通讯
22	地平线
23	拉杜加
24	闪电
二十五	二甲基碳
二十六	阿尔戈斯
二十七	行星
二十八	尖塔
二十九	星链
三十	OneWeb

API 密钥限制

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

每小时 1,000 个请求
所有端点的基本功能

使用服务器时请注意这些限制，以避免超出您的配额。

故障排除

API 密钥错误：确保您的 N2YO API 密钥有效并在环境变量中正确设置。
速率限制：如果遇到速率限制错误，服务器将自动以指数退避重试，但您可能需要等待才能发出其他请求。
未找到数据：某些卫星可能没有可用的实时跟踪数据，尤其是较旧或不活动的卫星。

执照

该项目已获得 ISC 许可。

Satellite Tracking MCP Server

Integrations