GeoFS MCP

GeoFS MCP服务器

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

特性

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

先决条件

• Node.js（v14或更高版本）
• npm或纱线
• 现代网络浏览器（推荐使用Chrome）

安装

1. 克隆此存储库：

   git clone https://github.com/yourusername/geofs-mcp-server.git
   cd geofs-mcp-server

1. 安装依赖项：

   npm install

1. 构建项目：

   npm run build

用法

启动服务器

1. 启动MCP服务器：

   npm start

1. 服务器将启动一个导航到GeoFS的浏览器窗口

- 如果需要，您可能需要登录GeoFS - 服务器将等待GeoFS完全加载，然后再接受命令

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

// Example WebSocket message
{
  "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许可证获得许可-有关详细信息，请参阅许可证文件。

致谢

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