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 协议保护。

👏 鸣谢

感谢以下人员和组织对项目的贡献：

• 开发团队
• 社区支持者
• 以及其他合作伙伴