Satellite Tracking MCP Server

卫星跟踪MCP服务器

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

特性

此MCP服务器提供以下功能：

工具

• get_卫星_位置：通过NORAD ID获取卫星的实时位置
• get_卫星_tle：通过NORAD ID获取卫星的TLE（双线元素）数据
• 预测视觉通行证：预测卫星在某一位置的可见经过
• 预测_无线电路径：预测卫星在某一位置的射频通过情况
• get_卫星_以上：获取当前位于指定位置上方的卫星
• 搜索卫星：按名称或类别搜索卫星

资源

• 卫星：//{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

1. 构建服务器：

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一起使用，以访问卫星跟踪数据：

获取卫星位置

satellite-tracking
get_satellite_position

{
  "norad_id": 25544,
  "observer_lat": 40.7128,
  "observer_lng": -74.0060
}

获取卫星TLE数据

satellite-tracking
get_satellite_tle

{
  "norad_id": 25544
}

预测视觉通行

satellite-tracking
predict_visual_passes

{
  "norad_id": 25544,
  "observer_lat": 40.7128,
  "observer_lng": -74.0060,
  "days": 7
}

搜索卫星

satellite-tracking
search_satellites

{
  "query": "ISS"
}

获取位置上方的卫星

satellite-tracking
get_satellites_above

{
  "observer_lat": 40.7128,
  "observer_lng": -74.0060,
  "search_radius": 45
}

访问卫星资源

satellite-tracking
satellite://25544

卫星类别

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

API关键限制

N2YO API的使用限制取决于您的订阅计划。免费等级允许：

• 每小时1000个请求
• 所有端点的基本功能

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

故障排除

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

许可证

该项目根据ISC许可证获得许可。