GeoFS MCP Server

GeoFS MCP サーバー

GeoFS フライト シミュレータ用のモデル コンテキスト プロトコル (MCP) サーバー。これにより、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 もサポートしています。

使用可���なコマンド:

• setThrottle - エンジンスロットルを設定する（0-1）
• setHeading - 目標の方向を度単位で設定する
• getPosition - 現在の航空機の位置を取得する
• selectAircraft - 別の航空機に変更する
• takeOff - 離陸手順を実行する
• land - 着陸手順を実行する
• getFlightData - 包括的なフライトデータを取得する

クライアントの例

GeoFS MCP サーバーに接続して使用する方法の基本的な例についてはexamples/simple-client.jsファイルを参照してください。

例を実行するには:

仕組み

GeoFS MCPサーバーは、Puppeteerを使用してGeoFSを実行するブラウザインスタンスを制御します。標準化されたMCPインターフェースを提供し、AIモデルがHTTPおよびWebSocket APIを介してフライトシミュレータと対話できるようにします。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

謝辞

• GeoFS - ブラウザベースのフライトシミュレーター
• モデルコンテキストプロトコル- AIモデルコンテキストのプロトコル仕様