GeoFS MCP Server

Integrations

  • Enables control and interaction with aircraft in the GeoFS browser-based flight simulator, allowing for setting flight parameters, retrieving real-time flight data, navigating between waypoints, and executing flight maneuvers through JavaScript APIs.

  • Powers the MCP server that bridges AI models with the GeoFS flight simulator, providing HTTP and WebSocket endpoints for aircraft control, flight data retrieval, and simulation management.

  • Used to programmatically control a browser instance running the GeoFS flight simulator, enabling automated interaction with the simulation environment.

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

// 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 ファイルを参照してください。

謝辞

-
security - not tested
F
license - not found
-
quality - not tested

標準化されたインターフェースを通じて、AI モデルが GeoFS ブラウザベースのフライト シミュレーター内の航空機を制御および操作できるようにするサーバー。

  1. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. Starting the Server
          2. Using with AI Models
          3. API Endpoints
          4. WebSocket Commands
        2. Example Client
          1. How It Works
            1. Contributing
              1. License
                1. Acknowledgements
                  ID: vhg9ud9l0a