article
README
🚀 GeoFS MCP 服务器
GeoFS MCP 服务器是一款专为 GeoFS 飞行模拟器打造的模型上下文协议(MCP)服务器。它为 AI 模型提供了强大的支持,使其能够轻松控制飞行模拟器中的飞机,并与之进行高效交互,极大地丰富了飞行模拟体验。
✨ 主要特性
- 🛫 精准控制飞机飞行参数,如油门、航向等,让飞行操作更加灵活。
- 📊 实时获取飞机的位置、速度、姿态等飞行数据,为飞行决策提供有力支持。
- 🗺️ 支持在航路点和机场之间进行智能导航,规划最佳飞行路线。
- ✈️ 提供多种飞机模型供用户选择,满足不同的飞行需求。
- 🔄 自动执行起飞、着陆等飞行程序,简化飞行流程。
📦 安装指南
先决条件
- Node.js(v14 或更高版本)
- npm 或 yarn
- 现代网页浏览器(推荐 Chrome)
安装步骤
- 克隆此仓库:
git clone https://github.com/yourusername/geofs-mcp-server.git cd geofs-mcp-server - 安装依赖项:
npm install - 构建项目:
npm run build
💻 使用示例
启动服务器
- 启动 MCP 服务器:
npm start - 服务器将自动打开一个浏览器窗口,并跳转到 GeoFS。
- 如果需要,您可能需要登录 GeoFS。
- 服务器将在 GeoFS 完全加载后开始接受命令。
- MCP 服务器将运行在以下地址:
- HTTP:
http://localhost:3000 - WebSocket:
ws://localhost:3000
- HTTP:
与 AI 模型配合使用
此 MCP 服务器可以与支持模型上下文协议的 AI 模型一起使用,允许它们:
- 控制模拟器中的飞机。
- 获取飞行数据和模拟器状态。
- 执行复杂飞行程序。
- 规划并遵循飞行路线。
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 协议保护。
👏 鸣谢
感谢以下人员和组织对项目的贡献:
- 开发团队
- 社区支持者
- 以及其他合作伙伴
扫码联系在线客服