Drone MCP

🚀 Tello 無人機 MCP 服務器

Tello 無人機 MCP 服務器是一個用於控制 DJI Tello 無人機的 Model Context Protocol (MCP) 服務器實現。它允許任何與 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 接口。

✨ 主要特性

• MCP 支持：提供對 Model Context Protocol (MCP) 的支持，實現標準化的無人機控制接口。
• 即時控制：通過 SSE（Server-Sent Events）進行即時無人機控制，確保操作的及時性。
• 健壯的錯誤處理和日誌記錄：全面處理各種錯誤情況，如無人機連接故障、無效命令等，並詳細記錄日誌。
• CORS 啟用：對所有來源啟用 CORS（*），適用於 web 客戶端，如 mcp 檢查器。
• 基本命令支持：支持起飛、著陸、移動（上/下/左/右/前/後）、旋轉（順時針/逆時針）等基本的 Tello 無人機命令。

💻 使用示例

基礎用法

起飛無人機

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"
}

高級用法

使用 SSE 接口發送命令

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

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

🔧 技術細節

服務器使用以下技術構建：

• Python 的 mcp 庫用於協議處理，確保對 MCP 協議的高效支持。
• Starlette 用於 HTTP/SSE 傳輸，提供穩定的網絡通信。
• Uvicorn 作為 ASGI 服務器，保證高性能的服務運行。
• 原生 Python 套接字庫用於無人機 UDP 通信，實現與 Tello 無人機的可靠連接。

📄 許可證

本項目採用 MIT 許可證。

⚠️ 重要提示

• 此項目正在積極開發中，請閱讀安全注意事項。
• 服務器需要 root/sudo 訪問權限以綁定 UDP 端口。
• 沒有實現身份驗證，依賴於網絡安全性。
• CORS 對所有來源啟用（*），僅在受控環境中使用。

💡 使用建議

服務器無法啟動

• 確保您有 sudo/root 訪問權限。
• 檢查 Tello 的 WiFi 是否已連接。
• 驗證沒有其他進程佔用端口 3000。

無人機無法連接

• 確保無人機已開啟電源。
• 檢查 WiFi 連接狀態。
• 驗證沒有其他應用程序在控制無人機。

命令失敗

• 檢查無人機電池電量。
• 確保無人機處於安全的飛行環境中。
• 驗證命令參數是否在允許範圍內。

貢獻

歡迎對本項目進行貢獻。