Tello 无人机 MCP 服务器

一个用于控制 DJI Tello 无人机的 Model Context Protocol (MCP) 服务器实现。此服务器允许任何与 MCP 兼容的客户端通过标准化接口控制 Tello 无人机。

注意事项

此项目正在积极开发中，阅读安全注意事项

功能

• MCP 支持
• 通过 SSE（Server-Sent Events）进行实时无人机控制
• 健壮的错误处理和日志记录
• CORS 启用（适用于 web 客户端，如 mcp 检查器）
• 支持基本的 Tello 无人机命令：
  • 起飞
  • 着陆
  • 移动（上/下/左/右/前/后）
  • 旋转（顺时针/逆时针）

先决条件

• Python 3.7+
• DJI Tello 无人机
• 与 Tello 无人机的网络连接
• 根用户或 sudo 访问权限（用于绑定 UDP 套接字）

安装

1. 克隆此仓库：

git clone <repository-url>
cd drone-mcp

2. 安装依赖项：

pip install -r requirements.txt

MCP 配置

要使您的 MCP 客户端连接到 Tello 无人机服务器，请在 mcp.json 文件中添加以下配置（通常位于 ~/.cursor/mcp.json 或项目目录中）：

{
  "tello-drone": {
    "url": "http://localhost:3000/sse"
  }
}

此配置允许 MCP 工具和模型自动发现并连接到您的 Tello 无人机服务器。

使用方法

1. 连接到您的 Tello 无人机的 WiFi 网络（通常以“TELLO-”开头）。

2. 启动服务器：

python -m mcp server --config config.yaml

3. 访问 http://localhost:8000 查看文档和 API 接口。

提供的工具

起飞无人机

请求

curl http://localhost:8000/api/drone/takeoff -X POST

响应

{
  "result": true,
  "message": "Drone has taken off"
}

着陆无人机

请求

curl http://localhost:8000/api/drone/land -X POST

响应

{
  "result": true,
  "message": "Drone is landing"
}

客户端集成

发送命令到无人机

使用 HTTP 或 SSE 接口发送起飞或着陆命令：

请求 (HTTP)

curl http://localhost:8000/api/drone/takeoff -X POST

响应

{
  "result": true,
  "message": "Command sent to drone"
}

请求 (SSE)

const eventSource = new EventSource('http://localhost:3000/sse');

eventSource.addEventListener('command', function(e) {
    console.log(e.data);
});

错误处理

服务器实现了全面的错误处理：

• 无人机连接故障
• 无效命令
• 网络超时
• 协议错误
• 无效工具参数

所有错误都会记录并在 JSON-RPC 2.0 格式的错误响应中返回。

日志记录

服务器将日志输出到 stderr，包含以下详细信息：

• 服务器启动/关闭状态
• 无人机连接状态
• 命令执行情况
• 客户端连接
• 错误条件

安全注意事项

• 服务器需要 root/sudo 访问权限以绑定 UDP 端口
• 没有实现身份验证（依赖于网络安全性）
• CORS 对所有来源启用（*）
• 仅在受控环境中使用

开发

服务器使用以下技术构建：

• Python 的 mcp 库用于协议处理
• Starlette 用于 HTTP/SSE 传输
• Uvicorn 作为 ASGI 服务器
• 原生 Python 套接字库用于无人机 UDP 通信

故障排除

1. 服务器无法启动：

   • 确保您有 sudo/root 访问权限
   • 检查 Tello 的 WiFi 是否已连接
   • 验证没有其他进程占用端口 3000

2. 无人机无法连接：

   • 确保无人机已开启电源
   • 检查 WiFi 连接状态
   • 验证没有其他应用程序在控制无人机

3. 命令失败：

   • 检查无人机电池电量
   • 确保无人机处于安全的飞行环境中
   • 验证命令参数是否在允许范围内

许可证

MIT

贡献

欢迎贡献。