Perigee

perigee-mcp

地球、月、火星を周回する人工天体や、太陽系を横断する宇宙船を表示するオープンソースの3Dビューアー、Perigee向けのMCPサーバーです。AI アシスタント（たとえば、教員アシスタント）が「2026年12月1日の火星と地球の距離は？」「ISSは今どこにある？」「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、アカウント不要。1アドレスあたり1分間に60ユニットまで。ツール呼び出し1回につき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 ID または 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	地球周回衛星が 1 周または 2 周する間に地表に描く軌跡：点と、日付変更線で分割された GeoJSON のライン
perigee_close_approach	ある期間における宇宙空間の 2 つのオブジェクト間の最接近距離と正確な時刻、および 2 つの衛星の相対速度（教育目的のみ。衝突回避には使用しないでください）
perigee_stats	所有者、運用者、コンステレーション、軌道分類、オブジェクトの種類、打ち上げ年、高度帯ごとの活動中の衛星数
perigee_distance	指定日時における 2 つのオブジェクト間の距離（km、au）と光行時間
perigee_distance_series	ある期間の距離と、最接近・最遠のサンプル
perigee_view	3D ビューへのリンクと、レッスンページ用のライブビューの <iframe>（ページから操作でき、perigee:v1 メッセージで PNG スナップショットを取得できます）。恒星の場合は太陽を含む 3D マップ（star_map、compare）
perigee_describe_view	Perigee のリンクまたは埋め込みの文章による説明：一文の代替テキストとレッスン用メモの説明（ビュー、オブジェクトと位置の信頼性、日時、時間の進み方、座標系、フィルター）
perigee_define	学生向けの定義（英語／フランス語）：遠地点、軌道傾斜角、NORAD 番号、エフェメリスの期間など
perigee_about	データソースと取得時刻、モデルとその一般的な精度、クレジット
計算された回答にはすべて、provenance リストが含まれます。このリストには、モデル（CelesTrak GP または補足 GP 要素の SGP4、JPL Horizons ベクトルのエルミート補間、二体外挿、惑星の VSOP87、月の解析モデルまたは平均要素）、データの状態（fresh、interpolated、stale、extrapolated、hidden、modelled、none）、データの取得日時、軌道要素の経過時間、暦の適用期間、根拠を添えた標準的な精度が記載されています。

データ

位置は、ウェブアプリと同じコードを使い、Perigee が公開するデータ（4 時間ごとに更新される CelesTrak の要素、毎日の JPL Horizons 暦）から、お使いのマシン上で計算されます（https://perigee.info/data/）。各データセットのバージョンは一度だけダウンロードされ、キャッシュに保存されます（%LOCALAPPDATA%\perigee-mcp、~/Library/Caches/perigee-mcp、または ~/.cache/perigee-mcp。PERIGEE_MCP_CACHE で上書きできます）。サーバーが CelesTrak や Horizons に接続することはありません。別の Perigee デプロイ先を指定するには、PERIGEE_SITE を設定します。

クレジット：CelesTrak（T.S. Kelso）／Space-Track 経由の第 18・第 19 宇宙防衛飛行隊（SDS）、NASA/JPL-Caltech Horizons、astronomy-engine（MIT）、satellite.js（MIT）；カタログ画像はそれぞれに付属するライセンスに基づきます。コード：MIT、https://github.com/dlamarre-dev/Perigee。