MCP 服务器

Tello Drone MCP Server

用于控制无人机的 MCP 服务器 (Yòng yú kòngzhì wúrénjī de MCP fúwùqì)

0xKoda

开发者工具

访问服务器

README

Tello 无人机 MCP 服务器

一个用于控制 DJI Tello 无人机的模型上下文协议 (MCP) 服务器实现。该服务器允许任何兼容 MCP 的客户端通过标准化接口控制 Tello 无人机。

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

功能

MCP 支持
通过 SSE（服务器发送事件）进行实时无人机控制
强大的错误处理和日志记录
启用 CORS 以支持 Web 客户端（如 mcp inspector）
支持基本的 Tello 无人机命令：
- 起飞
- 降落
- 移动（上/下/左/右/前/后）
- 旋转（顺时针/逆时针）

前提条件

Python 3.7+
DJI Tello 无人机
与 Tello 无人机的网络连接
Root/sudo 访问权限（UDP 套接字绑定需要）

安装

克隆此存储库：

git clone <repository-url>
cd drone-mcp

安装依赖项：

pip install -r requirements.txt

MCP 配置

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

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

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

用法

连接到您的 Tello 无人机的 WiFi 网络（通常以 "TELLO-" 开头）。
启动 MCP 服务器：

sudo python tello_mcp.py

服务器将：

初始化与 Tello 无人机的连接
在 http://0.0.0.0:3000 上启动 MCP 服务器
在 /sse 设置 SSE 端点
处理 /message 上的消息

请确保服务器在您计划在客户端（cursor, windsurf, code）中使用它之前正在运行。

可用工具

服务器提供以下 MCP 工具：

1. Takeoff

{
    "name": "takeoff",
    "description": "命令 Tello 无人机起飞",
    "inputSchema": {
        "type": "object",
        "properties": {}
    }
}

2. Land

{
    "name": "land",
    "description": "命令 Tello 无人机降落",
    "inputSchema": {
        "type": "object",
        "properties": {}
    }
}

3. Move

{
    "name": "move",
    "description": "在指定方向移动 Tello 无人机",
    "inputSchema": {
        "type": "object",
        "properties": {
            "direction": {
                "type": "string",
                "enum": ["up", "down", "left", "right", "forward", "back"]
            },
            "distance": {
                "type": "integer",
                "minimum": 20,
                "maximum": 500
            }
        },
        "required": ["direction", "distance"]
    }
}

4. Rotate

{
    "name": "rotate",
    "description": "顺时针或逆时针旋转 Tello 无人机",
    "inputSchema": {
        "type": "object",
        "properties": {
            "direction": {
                "type": "string",
                "enum": ["cw", "ccw"]
            },
            "degrees": {
                "type": "integer",
                "minimum": 1,
                "maximum": 3600
            }
        },
        "required": ["direction", "degrees"]
    }
}

MCP 客户端集成

要连接 MCP 客户端：

启动您的服务器并连接到 SSE 端点：

GET http://localhost:3000/sse

提示您启用 MCP 的模型，它将通过 SSE 进行通信

event: endpoint
data: /message?sessionId=<session-id>

发送初始化请求：

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize"
}

列出可用工具：

{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "listTools"
}

调用一个工具（示例 - 起飞）：

{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "callTool",
    "params": {
        "name": "takeoff",
        "arguments": {}
    }
}

错误处理

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

无人机连接失败
无效命令
网络超时
协议错误
无效的工具参数

所有错误都会被记录并作为正确的 JSON-RPC 2.0 错误响应返回。

日志记录

服务器将详细信息记录到 stderr：

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

安全注意事项

服务器需要 root/sudo 访问权限才能绑定到 UDP 端口
未实现身份验证（依赖于网络安全）
为所有来源 (*) 启用了 CORS
仅在受控环境中使用

开发

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

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

故障排除

服务器无法启动：
- 确保您具有 sudo/root 访问权限
- 检查 Tello 的 WiFi 是否已连接
- 验证没有其他进程正在使用端口 3000
无人机无法连接：
- 确保无人机已开机
- 检查 WiFi 连接
- 验证没有其他应用程序正在控制无人机
命令失败：
- 检查无人机电池电量
- 确保无人机处于安全的飞行环境中
- 验证命令参数是否在允许的范围内