卫星跟踪 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} :指定位置上方的卫星列表
Related MCP server: MISP-MCP-SERVER
安装
先决条件
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 许可。