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 进行实时通信：

// 示例 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 与飞行模拟器进行交互。

贡献

欢迎贡献！请随意提交拉取请求。

许可证

本项目根据 MIT 许可证发布 - 查看 LICENSE 文件获取详情。

致谢

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