使用说明

项目简介

GeoFS-MCP服务器是一个基于Node.js构建的应用程序，它充当AI模型和GeoFS飞行模拟器之间的桥梁。通过实现模型上下文协议(MCP)，该服务器允许AI客户端以标准化的方式控制GeoFS中的飞机，并获取实时的飞行数据。这为开发智能飞行助手、自动化飞行脚本等应用提供了基础。

主要功能点

飞机控制：支持控制飞机的油门、航向等飞行参数，实现对飞机的精细操作。
实时数据访问：提供实时的飞行数据，包括位置、速度、姿态等关键信息，使AI模型能够感知飞行环境。
导航功能：支持在航点和机场之间导航，允许AI模型规划和执行复杂的飞行路线。
飞机选择：可以切换不同的飞机模型，适应不同的飞行任务和场景。
飞行机动：能够执行起飞、着陆等预定义的飞行机动动作。
WebSocket和HTTP API：提供WebSocket和HTTP两种通信方式，满足不同客户端的需求。

安装步骤

克隆仓库 打开终端，执行以下命令克隆 'geofs-mcp' 仓库到本地：

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

安装依赖 在仓库根目录下，执行以下命令安装项目依赖：
```
npm install
```
构建项目 执行以下命令构建项目：
```
npm run build
```

服务器配置

MCP客户端需要配置以下信息以连接到 GeoFS-MCP 服务器。以下是一个示例 JSON 配置，您可以根据实际情况进行调整：

{
  "serverName": "GeoFS-MCP Server",
  "command": "npm",
  "args": ["start"],
  "description": "启动 GeoFS MCP 服务器，连接到 GeoFS 飞行模拟器",
  "protocol": "websocket",
  "address": "ws://localhost:3002"
}

参数注释:

'serverName': MCP 服务器的名称，可以自定义，用于在客户端界面上标识服务器。
'command': 启动 MCP 服务器的命令。这里使用 'npm'，假设您已经全局安装了 Node.js 和 npm。
'args': 启动命令的参数。'start' 是 'package.json' 中定义的启动脚本，用于运行服务器。
'description': 对该服务器配置的简短描述，方便用户理解其用途。
'protocol': 客户端与服务器通信的协议，这里配置为 'websocket'，GeoFS-MCP 服务器主要通过 WebSocket 提供实时通信。
'address': WebSocket 服务器地址。'ws://localhost:3002' 是 GeoFS-MCP 服务器默认的 WebSocket 地址。如果服务器部署在不同的主机或端口，请相应修改。

注意: MCP客户端需要能够执行 'npm start' 命令来启动服务器。请确保您的运行环境中已安装 Node.js 和 npm，并且配置了正确的环境变量。

基本使用方法

启动服务器 在仓库根目录下，执行以下命令启动 GeoFS MCP 服务器：
```
npm start
```
服务器启动后，会自动打开浏览器并导航到 GeoFS 飞行模拟器网站。您可能需要登录 GeoFS 账号。服务器会等待 GeoFS 完全加载后才接受命令。
连接客户端 开发 MCP 客户端（例如AI模型客户端），并根据上述【服务器配置】部分提供的配置信息，连接到 GeoFS-MCP 服务器的 WebSocket 地址 ('ws://localhost:3002')。

发送指令 客户端通过 WebSocket 向服务器发送 JSON 格式的指令，例如控制飞机油门：

{
  "id": 1,
  "type": "command",
  "command": "setThrottle",
  "params": {
    "value": 0.75
  }
}

服务器会解析指令并控制 GeoFS 模拟器中的飞机，然后通过 WebSocket 返回响应或发送通知。

获取数据 客户端可以发送指令获取实时飞行数据，例如：

{
  "id": 2,
  "type": "command",
  "command": "getFlightData"
}

服务器会将当前的飞行数据封装成 JSON 格式并通过 WebSocket 返回给客户端。

集成AI模型 将 MCP 客户端集成到您的 AI 模型中，使 AI 模型能够通过 GeoFS-MCP 服务器与 GeoFS 飞行模拟器进行交互，实现更高级的智能飞行控制功能。

示例客户端 仓库的 'examples' 目录下提供了简单的客户端示例，可以参考 'simple-client.js' 和 'claude-pilot.js' 了解如何与 GeoFS-MCP 服务器进行通信和控制。

关键词