返回 MCP 目录
public公开dns本地运行

GeoFS Flight Simulator

GeoFS MCP服务器是一个为GeoFS飞行模拟器设计的模型上下文协议服务器,通过HTTP和WebSocket接口让AI模型能够控制飞机并获取实时飞行数据。

article

README

🚀 GeoFS MCP 服务器

GeoFS MCP 服务器是一款专为 GeoFS 飞行模拟器打造的模型上下文协议(MCP)服务器。它为 AI 模型提供了强大的支持,使其能够轻松控制飞行模拟器中的飞机,并与之进行高效交互,极大地丰富了飞行模拟体验。

image image image

✨ 主要特性

  • 🛫 精准控制飞机飞行参数,如油门、航向等,让飞行操作更加灵活。
  • 📊 实时获取飞机的位置、速度、姿态等飞行数据,为飞行决策提供有力支持。
  • 🗺️ 支持在航路点和机场之间进行智能导航,规划最佳飞行路线。
  • ✈️ 提供多种飞机模型供用户选择,满足不同的飞行需求。
  • 🔄 自动执行起飞、着陆等飞行程序,简化飞行流程。

📦 安装指南

先决条件

  • 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": "调整油门"
}

示例客户端

要连接到 MCP 服务器并控制飞机,您可以使用以下 JavaScript 客户端代码:

const ws = new WebSocket('ws://localhost:3000');
ws.onmessage = (event) => {
    console.log('收到消息:', event.data);
};

工作原理

MCP 服务器为 GeoFS 飞行模拟器提供了一个接口,允许外部系统通过 HTTP 和 WebSocket 协议与其交互。它支持实时数据传输和命令控制,使 AI 模型能够无缝集成到飞行模拟环境中。

📚 详细文档

如果要贡献到此项目,请参考 CONTRIBUTING.md 文件。

📄 许可证

本项目受 LICENSE 协议保护。

👏 鸣谢

感谢以下人员和组织对项目的贡献:

  • 开发团队
  • 社区支持者
  • 以及其他合作伙伴
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端