GeoFS MCP サーバー

GeoFS フライト シミュレータ用のモデル コンテキスト プロトコル (MCP) サーバー。これにより、AI モデルが GeoFS ブラウザーベースのフライト シミュレータで航空機を制御および操作できるようになります。

特徴

• 🛫 航空機の飛行パラメータ（スロットル、方位など）を制御する

• 📊 リアルタイムの飛行データ（位置、速度、姿勢）にアクセス

• 🗺️ ウェイポイントと空港間を移動する

• ✈️ さまざまな航空機モデルを選択する

• 🔄飛行操作（離陸、着陸）を実行する

Related MCP server: Playwright MCP Server

前提条件

• 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 もサポートしています。

// Example WebSocket message
{
  "id": 1,
  "type": "command",
  "command": "setThrottle",
  "params": {
    "value": 0.75
  }
}

使用可能なコマンド:

• setThrottle - エンジンスロットルを設定する（0-1）

• setHeading - 目標の方向を度単位で設定する

• getPosition - 現在の航空機の位置を取得する

• selectAircraft - 別の航空機に変更する

• takeOff - 離陸手順を実行する

• land - 着陸手順を実行する

• getFlightData - 包括的なフライトデータを取得する

クライアントの例

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

例を実行するには:

node examples/simple-client.js

仕組み

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

貢献

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

ライセンス

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

謝辞

• GeoFS - ブラウザベースのフライトシミュレーター

• モデルコンテキストプロトコル- AIモデルコンテキストのプロトコル仕様