GeoFS MCP Server

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

可用命令：

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

示例客户端

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

运行示例：

工作原理

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

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

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

致谢

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