Perigee

perigee-mcp

这是一个面向 Perigee 的 MCP 服务。Perigee 是一款开源 3D 查看器，用于查看环绕地球、月球和火星的人造天体，以及穿越太阳系的航天器。它能让 AI 助手（例如教学助手）回答“2026 年 12 月 1 日火星距离地球有多远？”、“国际空间站现在在哪里？”或“Lucy 的任务是什么？”等问题，并向学生展示实时 3D 视图，同时说明每个数字是如何得出的、数据来源是什么、数据有多新以及有多准确。

仅供教育用途：不得用于导航、规避碰撞或会合分析。

使用方法

Claude Desktop（claude_desktop_config.json）或任何通过 stdio 启动服务的 MCP 客户端：

{
  "mcpServers": {
    "perigee": { "command": "npx", "args": ["-y", "perigee-mcp"] }
  }
}

Claude Code：claude mcp add perigee -- npx -y perigee-mcp。需要 Node.js 20 或更高版本。

托管服务，无需安装：同样的工具也可通过 https://perigee-mcp.perigeeinfo.workers.dev/mcp 使用（Streamable HTTP，无需账号，每个地址每分钟限额为 60 个单位，每次工具调用消耗 1 到 4 个单位）。Claude.ai：进入 Settings → Connectors → Add custom connector，填入该 URL；Claude Code： claude mcp add --transport http perigee https://perigee-mcp.perigeeinfo.workers.dev/mcp。距离序列最多包含 100 个样本，过境搜索范围最多为 3 天，事件搜索范围最多为 31 天。托管端点会保留简短的使用日志（工具、查询的对象、结果；绝不记录你的地址或地点坐标；参见隐私页面）。

工具

工具	返回内容
perigee_find	与名称匹配的对象 ID（英语或法语）：行星、卫星、任务、任何在役地球卫星（名称、NORAD 或 COSPAR ID）、地点、恒星、彗星、小行星
perigee_object	事实信息：机构、国家、发射、状态、任务目标、标识符、官方网站、来源和核验日期、带署名和许可信息的图片
perigee_state	相对于某个中心在指定日期的位置和速度、距离、高度、速率、光行时、日照情况；下方的地面点（地球上的国家或海域）
perigee_orbit	近地点和远地点高度、周期、倾角、偏心率；地球卫星的轨道类型（LEO、MEO、GEO、HEO）
perigee_passes	地球卫星经过某地点上空的时间：升起、最高点和落下时的方向与仰角、肉眼可见性、本地时间
perigee_sky	某地点在指定日期的天空状况：白昼、曙暮光或夜晚，太阳及其下一次升起和落下时间，月相，以及行星和亮星的方向、亮度和肉眼可见性
perigee_events	月相（超级月亮和微型满月）、日食和月食（包括某地点所见）、春分秋分、夏至冬至、近日点、行星冲日、合相和距角、任务里程碑
perigee_tonight	某地点今晚可观测的天象：夜晚的开始和结束时间、月亮、肉眼可见的行星、ISS、Tiangong 和 Hubble 的可见过境、近距离相伴天体和事件，并附简短亮点
perigee_sky_conjunctions	某地点天空中的近距离相伴天体：黄道附近的月亮和行星彼此之间及其与亮星之间的相伴情况，或卫星从它们附近经过
perigee_shadow	对象是否处于其所绕行天体的日照区、半影或本影中，以及下一次进入或离开阴影的时间
perigee_ground_track	地球卫星一至两圈轨道期间下方地面的轨迹：轨迹点和一条在日期变更线处分段的 GeoJSON 线
perigee_close_approach	两个太空对象在一段时间内的最近距离及其精确时间，以及两颗卫星的相对速度（仅供教育用途，绝不可用于防碰撞）
perigee_stats	按所有者、运营方、星座、轨道类型、对象类型、发射年份和高度区间统计的在役卫星数量
perigee_distance	两个对象在指定日期的距离（km、au）和光行时
perigee_distance_series	一段时间内的距离，以及距离最近和最远的采样点
perigee_view	3D 视图链接，以及用于课程页面的实时视图 <iframe>（页面可通过 perigee:v1 消息控制视图并截取 PNG 快照）；对于恒星，返回其与太阳的 3D 星图（star_map、compare）
perigee_describe_view	用文字描述 Perigee 链接或嵌入内容：一句话替代文本，以及供课程笔记使用的说明（视图、对象及其位置的可靠性、日期、时间流速、参考系、筛选条件）
perigee_define	面向学生的定义（EN/FR）：远地点、倾角、NORAD 编号、星历时间范围等
perigee_about	数据来源和获取时间、模型及其典型精度、署名信息
每个计算结果都有一个 provenance 列表，其中包含模型（来自 CelesTrak GP 或补充 GP 轨道根数的 SGP4、JPL Horizons 矢量的 Hermite 插值、二体外推、用于行星的 VSOP87、用于卫星的解析模型或平根数）、数据状态（fresh、interpolated、stale、extrapolated、hidden、modelled、none）、数据的获取时间、轨道根数的时效、历表窗口，以及标明依据的典型精度。

数据

位置会在你的机器上使用与 Web 应用相同的代码计算，所用数据来自 Perigee 在 https://perigee.info/data/ 发布的内容（CelesTrak 轨道根数每 4 小时刷新一次，JPL Horizons 历表每天更新）。每个数据集版本只下载一次，并保存在缓存中（%LOCALAPPDATA%\perigee-mcp、~/Library/Caches/perigee-mcp 或 ~/.cache/perigee-mcp；PERIGEE_MCP_CACHE 可覆盖该路径）。服务不会联系 CelesTrak 或 Horizons。 PERIGEE_SITE 可将其指向另一个 Perigee 部署。

鸣谢：CelesTrak（T.S. Kelso）/ 第 18 和第 19 太空防御中队（通过 Space-Track）、NASA/JPL-Caltech Horizons、astronomy-engine（MIT）、 satellite.js（MIT）；目录图片遵循各自附带的许可协议。代码：MIT，https://github.com/dlamarre-dev/Perigee。