🚀 卫星跟踪 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。
安装步骤
- 下载并安装 Node.js（建议版本 14 或以上）。
- 克隆本项目到本地开发环境。
- 安装依赖项：
npm install - 配置环境变量：
- 创建或编辑环境变量文件
.env。 - 添加以下内容：
N2YO_API_KEY=your_api_key_here
- 创建或编辑环境变量文件
- 启动服务器：
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 许可证。