GeoFS MCP 服务器

一个用于 GeoFS 飞行模拟器的模型上下文协议 (MCP) 服务器，允许 AI 模型控制 GeoFS 基于浏览器的飞行模拟器中的飞机并与之交互。

特性

• 🛫 控制飞机飞行参数（油门、航向等）
• 📊 访问实时飞行数据（位置、速度、姿态）
• 🗺️ 在航路点和机场之间导航
• ✈️ 选择不同的飞机模型
• 🔄 执行飞行机动（起飞、着陆）

前提条件

• Node.js (v14 或更高版本)
• npm 或 yarn
• 现代 Web 浏览器（推荐 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": "setThrottle",
  "params": {
    "value": 0.75
  }
}

可用命令：

• setThrottle - 设置发动机油门 (0-1)
• setHeading - 设置目标航向（度）
• getPosition - 获取当前飞机位置
• selectAircraft - 更改为不同的飞机
• takeOff - 执行起飞程序
• land - 执行着陆程序
• getFlightData - 获取全面的飞行数据

客户端示例

请参阅 examples/simple-client.js 文件，了解如何连接和使用 GeoFS MCP 服务器的基本示例。

要运行示例：

node examples/simple-client.js

工作原理

GeoFS MCP 服务器使用 Puppeteer 控制运行 GeoFS 的浏览器实例。 它提供了一个标准化的 MCP 接口，允许 AI 模型通过 HTTP 和 WebSocket API 与飞行模拟器交互。

贡献

欢迎贡献！ 请随时提交 Pull Request。

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• GeoFS - 基于浏览器的飞行模拟器
• 模型上下文协议 - AI 模型上下文的协议规范