卫星跟踪 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 Services 获取）

设置

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	伽利略
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 许可证获得许可。