Satellitetracking MCP Server

🚀 衛星追跡 MCP サーバー

このサーバーは、N2YO API を使用して衛星追跡データへのアクセスを提供する Model Context Protocol (MCP) サーバーです。衛星の位置情報や TLE データの取得、可視パスや無線パスの予測など、様々な機能を提供します。

🚀 クイックスタート

この衛星追跡 MCP サーバーは、N2YO API を利用して衛星に関するさまざまな情報を取得できます。以下に、サーバーのセットアップと基本的な使用方法を説明します。

✨ 主な機能

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

ツール

• 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 にアクセスするためのインターネット接続が必要です。

インストール手順

1. Node.js をダウンロードしてインストールします（推奨バージョン 14 以上）。
2. このプロジェクトをローカル開発環境にクローンします。
3. 依存関係をインストールします。

   npm install
   

4. 環境変数を設定します。
   • 環境変数ファイル .env を作成または編集します。
   • 以下の内容を追加します。

     N2YO_API_KEY=your_api_key_here
     

5. サーバーを起動します。

   npm start
   

🔧 設定

環境変数

• N2YO_API_KEY: 必須です。N2YO API のアクセスキーを取得して設定してください。

設定ファイル

• プロジェクトのルートディレクトリにある config.json ファイルには、以下のデフォルト設定が含まれています。

  {
    "port": 3000,
    "apiEndpoint": "https://api.n2yo.com"
  }
  

💻 使用例

衛星の位置情報を取得する

curl http://localhost:3000/api/satellite/position?noradId=25544

すべてのカテゴリの衛星を検索する

curl http://localhost:3000/api/satellites?category=0

📚 ドキュメント

衛星分類

サーバーは以下の衛星分類をサポートしています。

API キーの制限

N2YO API の使用制限は以下の通りです（無料版）。

• 1 時間あたり最大 1,000 回のリクエスト
• すべてのエンドポイントの基本機能が利用可能です。

これらの制限に注意して、クォータを超えないようにしてください。

トラブルシューティング

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

📄 ライセンス

このプロジェクトは ISC ライセンスの下で提供されています。