satellitetracking-mcp-server

🚀 卫星跟踪 MCP 服务器

卫星跟踪 MCP 服务器借助 N2YO API，提供卫星追踪数据的访问服务。它能让用户便捷获取各类卫星信息，满足不同场景下对卫星数据的需求。

🚀 快速开始

本服务器可通过简单的步骤完成安装与启动，为你提供卫星追踪数据的访问服务。

✨ 主要特性

工具

• get_satellite_position：获取指定 NORAD ID 的卫星实时位置。
• get_satellite_tle：获取指定 NORAD ID 卫星的 TLE（Two-Line Element）数据。
• predict_visual_passes：根据地理位置预测可见卫星过顶时间。
• predict_radio_passes：根据地理位置预测无线电频率下卫星过顶时间。
• get_satellites_above：获取当前位于指定位置上方的卫星列表。
• search_satellites：搜索卫星名称或类别。

资源

• satellite://ID：获取指定 ID 的卫星信息。
• category://ID：获取指定类别的卫星列表。

📦 安装指南

系统要求

• 操作系统：Linux、Windows、macOS。
• 内存：至少 512MB。
• 网络：需要互联网连接访问 N2YO API。

安装步骤

1. 下载并安装 Node.js（建议版本 14 或以上）。
2. 克隆本项目到本地开发环境。
3. 安装依赖项：

   npm install
   

4. 配置环境变量：
   • 创建或编辑环境变量文件 .env。
   • 添加以下内容：

     N2YO_API_KEY=your_api_key_here
     

5. 启动服务器：

   npm start
   

📚 详细文档

配置

环境变量

• N2YO_API_KEY：必填，获取你的 N2YO API 访问密钥。

配置文件

• 项目根目录下的 config.json 文件包含以下默认配置：

  {
    "port": 3000,
    "apiEndpoint": "https://api.n2yo.com"
  }
  

卫星分类

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

| 分类 ID | 描述 | |--------|------------| | 0 | 所有 | | 1 | 业余无线电 | | 2 | CubeSat | | 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 密钥有效且已正确设置在环境变量中。
• 速率限制：如果遇到速率限制错误，服务器会自动重试并使用指数回退算法，但你可能需要等待后再进行更多请求。
• 无数据返回：有些卫星可能没有实时追踪数据可用，特别是老旧或已退役的卫星。

💻 使用示例

基础用法

获取卫星位置信息

curl http://localhost:3000/api/satellite/position?noradId=25544

搜索所有类别下的卫星

curl http://localhost:3000/api/satellites?category=0

📄 许可证

本项目使用 ISC 许可证。