衛星追跡MCPサーバー

N2YO API を使用して衛星追跡データへのアクセスを提供するモデルコンテキストプロトコル (MCP) サーバー。

特徴

この MCP サーバーは次の機能を提供します。

ツール

get_satellite_position : NORAD IDで衛星のリアルタイム位置を取得する
get_satellite_tle : NORAD IDで衛星のTLE（2ラインエレメント）データを取得する
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 サービスから入手可能)

設定

このリポジトリをクローンするか、ソースコードをダウンロードしてください
依存関係をインストールします:

cd satellite-tracking-server
npm install

サーバーを構築します。

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	キューブサット
3	教育
4	エンジニアリング
5	ガリレオ
6	グローオプス
7	GPS-OPS
8	軍隊
9	レーダー
10	リソース
11	サーサット
12	科学
13	TDRSS
14	天気
15	XM/シリウス
16	イリジウムNEXT
17	グローバルスター
18	インテルサット
19	社会保障
20	テレサット
21	オーブコム
22	ゴリゾント
23	ラドゥガ
24	モルニヤ
25	DMC
26	アルゴス
27	惑星
28	尖塔
29	スターリンク
30	ワンウェブ

APIキーの制限

N2YO APIには、ご契約のサブスクリプションプランに応じた使用制限があります。無料プランでは以下の機能がご利用いただけます。

1時間あたり1,000件のリクエスト
すべてのエンドポイントにわたる基本機能

サーバーの使用時には、クォータを超過しないようにこれらの制限に注意してください。

トラブルシューティング

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

ライセンス

このプロジェクトは ISC ライセンスに基づいてライセンスされています。

Satellite Tracking MCP Server