GeoFS MCP 服务器

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

特征

• 🛫 控制飞机飞行参数（油门、航向等）

• 📊 访问实时飞行数据（位置、速度、姿态）

• 🗺️ 在航点和机场之间导航

• ✈️选择不同的飞机模型

• 🔄 执行飞行动作（起飞、降落）

Related MCP server: Playwright MCP Server

先决条件

• 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 模型上下文的协议规范