Satellite Tracking MCP Server

衛星追跡 MCP サーバー

N2YO API を使用して衛星追跡データにアクセスできる Model Context Protocol（MCP）サーバーです。

機能

この MCP サーバーでは、次の機能を利用できます。

ツール

• get_satellite_position：NORAD ID を指定して衛星のリアルタイム位置を取得します
• get_satellite_tle：NORAD ID を指定して衛星の TLE（軌道要素）データを取得します
• predict_visual_passes：指定した場所で衛星が目視できる通過時刻を予測します
• predict_radio_passes：指定した場所で衛星の電波が受信できる通過時刻を予測します
• get_satellites_above：指定した場所の上空に現在ある衛星を取得します
• search_satellites：名前またはカテゴリで衛星を検索します

リソース

• satellite://{norad_id}：NORAD ID で指定した衛星の情報
• satellites://category/{category_id}：特定のカテゴリに属する衛星の一覧
• satellites://above/{lat}/{lon}/{radius}：指定した場所の上空にある衛星の一覧

インストール

前提条件

• Node.js 18 以降
• N2YO API キー（N2YO API Services から取得できます）

セットアップ

1. このリポジトリをクローンするか、ソースコードをダウンロードします
2. 依存関係をインストールします：

cd satellite-tracking-server
npm install

3. サーバーをビルドします：

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 で衛星追跡データにアクセスできます。

衛星の位置を取得する

<use_mcp_tool>
<server_name>satellite-tracking</server_name>
<tool_name>get_satellite_position</tool_name>
<arguments>
{
  "norad_id": 25544,
  "observer_lat": 40.7128,
  "observer_lng": -74.0060
}
</arguments>
</use_mcp_tool>

衛星の TLE データを取得する

<use_mcp_tool>
<server_name>satellite-tracking</server_name>
<tool_name>get_satellite_tle</tool_name>
<arguments>
{
  "norad_id": 25544
}
</arguments>
</use_mcp_tool>

目視可能な通過時刻を予測する

<use_mcp_tool>
<server_name>satellite-tracking</server_name>
<tool_name>predict_visual_passes</tool_name>
<arguments>
{
  "norad_id": 25544,
  "observer_lat": 40.7128,
  "observer_lng": -74.0060,
  "days": 7
}
</arguments>
</use_mcp_tool>

衛星を検索する

<use_mcp_tool>
<server_name>satellite-tracking</server_name>
<tool_name>search_satellites</tool_name>
<arguments>
{
  "query": "ISS"
}
</arguments>
</use_mcp_tool>

指定した場所の上空にある衛星を取得する

<use_mcp_tool>
<server_name>satellite-tracking</server_name>
<tool_name>get_satellites_above</tool_name>
<arguments>
{
  "observer_lat": 40.7128,
  "observer_lng": -74.0060,
  "search_radius": 45
}
</arguments>
</use_mcp_tool>

衛星リソースにアクセスする

<access_mcp_resource>
<server_name>satellite-tracking</server_name>
<uri>satellite://25544</uri>
</access_mcp_resource>

衛星カテゴリ

サーバーでは、次の衛星カテゴリをサポートしています。

カテゴリ 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 時間あたり 1,000 リクエスト
• すべてのエンドポイントの基本機能

利用上限を超えないよう、サーバーを使用する際はこれらの制限に注意してください。

トラブルシューティング

• API キーのエラー：N2YO API キーが有効で、環境変数に正しく設定されていることを確認してください。
• レート制限：レート制限エラーが発生した場合、サーバーは指数バックオフで自動的に再試行します。ただし、追加リクエストを行う前に待機が必要な場合があります。
• データが見つからない：特に古い衛星や運用を停止した衛星では、リアルタイムの追跡データを利用できない場合があります。

ライセンス

このプロジェクトは ISC License のもとでライセンスされています。