Geofs Flight Simulator

🚀 GeoFS MCP サーバ

GeoFS 飛行シミュレータ用のモデルコンテキストプロトコル (MCP) サーバです。AI モデルが飛行シミュレータ内の飛行機を制御し、相互作用できるようにします。

🚀 クイックスタート

このサーバを使用することで、AI モデルが GeoFS 飛行シミュレータ内の飛行機を制御し、飛行データを取得できます。以下に、サーバのセットアップと使用方法を説明します。

✨ 主な機能

• 🛫 飛行機の飛行パラメータ（スロットル、針路など）を制御
• 📊 リアルタイムの飛行データ（位置、速度、姿勢）を取得
• 🗺️ ウェイポイントと空港間のナビゲーション
• ✈️ 異なる飛行機モデルを選択
• 🔄 飛行手順（離陸、着陸）を実行

📦 インストール

前提条件

• Node.js (v14 以上)
• npm または yarn
• 最新のウェブブラウザ（Chrome を推奨）

インストール手順

1. このリポジトリをクローンします：

   git clone https://github.com/yourusername/geofs-mcp-server.git
   cd geofs-mcp-server
   

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

💻 使用例

サーバの起動

1. MCP サーバを起動します：

   npm start
   

2. サーバがブラウザウィンドウを開き、GeoFS に遷移します。

   • 必要に応じて、GeoFS にログインする必要があります。
   • サーバは GeoFS が完全に読み込まれた後、コマンドを受け付け始めます。

3. MCP サーバは以下のアドレスで動作します：

   • HTTP: http://localhost:3000
   • WebSocket: ws://localhost:3000

AI モデルとの連携

この MCP サーバは、モデルコンテキストプロトコルをサポートする AI モデルと連携でき、以下のことが可能です：

1. シミュレータ内の飛行機を制御
2. 飛行データとシミュレータの状態を取得
3. 複雑な飛行手順を実行
4. 飛行ルートを計画し、従う

API エンドポイント

• GET /mcp - サーバの機能と利用可能なエンドポイントを取得
• GET /mcp/aircraft - 現在の飛行機データを取得
• POST /mcp/aircraft - 飛行機のパラメータを制御
• GET /mcp/flight-data - 包括的な飛行データを取得
• POST /mcp/navigation - ナビゲーションパラメータを設定
• GET /mcp/simulation - シミュレータの状態を取得
• POST /mcp/simulation - シミュレータのパラメータを制御

WebSocket コマンド

サーバはリアルタイム通信に WebSocket をサポートしています：

// サンプルの WebSocket メッセージ
{
  "id": 1,
  "type": "command",
  "command": "調整スロットル"
}

サンプルクライアント

MCP サーバに接続して飛行機を制御するには、以下の JavaScript クライアントコードを使用できます：

const ws = new WebSocket('ws://localhost:3000');
ws.onmessage = (event) => {
    console.log('受信メッセージ:', event.data);
};

基本的な使用法

MCP サーバは、GeoFS 飛行シミュレータに対するインターフェースを提供し、外部システムが HTTP および WebSocket プロトコルを介して相互作用できるようにします。リアルタイムデータ転送とコマンド制御をサポートし、AI モデルが飛行シミュレーション環境にシームレスに統合できるようにします。

📚 ドキュメント

貢献ガイド

このプロジェクトに貢献する場合は、CONTRIBUTING.md ファイルを参照してください。

ライセンス

このプロジェクトは LICENSE ライセンスの下で保護されています。

謝辞

このプロジェクトに貢献してくれた以下の人員と組織に感謝します：

• 開発チーム
• コミュニティの支持者
• その他のパートナー