Geofs Flight Simulator

🚀 GeoFS MCP 服務器

GeoFS MCP 服務器是一款專為 GeoFS 飛行模擬器打造的模型上下文協議（MCP）服務器。它為 AI 模型提供了強大的支持，使其能夠輕鬆控制飛行模擬器中的飛機，並與之進行高效交互，極大地豐富了飛行模擬體驗。

✨ 主要特性

• 🛫 精準控制飛機飛行參數，如油門、航向等，讓飛行操作更加靈活。
• 📊 即時獲取飛機的位置、速度、姿態等飛行數據，為飛行決策提供有力支持。
• 🗺️ 支持在航路點和機場之間進行智能導航，規劃最佳飛行路線。
• ✈️ 提供多種飛機模型供用戶選擇，滿足不同的飛行需求。
• 🔄 自動執行起飛、著陸等飛行程序，簡化飛行流程。

📦 安裝指南

先決條件

• 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 協議保護。

👏 鳴謝

感謝以下人員和組織對項目的貢獻：

• 開發團隊
• 社區支持者
• 以及其他合作伙伴