Drone MCP

🚀 Tello ドローン MCP サーバー

このサーバーは、DJI Tello ドローンを制御するための Model Context Protocol (MCP) サーバーの実装です。MCP 互換のクライアントは、このサーバーを通じて標準化されたインターフェースで Tello ドローンを制御することができます。

🚀 クイックスタート

このサーバーを使用することで、MCP 互換のクライアントから Tello ドローンを制御できます。以下に、基本的な手順を示します。

✨ 主な機能

• MCP サポート
• SSE（Server-Sent Events）によるリアルタイムのドローン制御
• 堅牢なエラー処理とログ記録
• CORS 有効化（mcp チェッカーなどの web クライアント用）
• 基本的な Tello ドローンコマンドのサポート：
  • 離陸
  • 着陸
  • 移動（上/下/左/右/前/後）
  • 回転（時計回り/反時計回り）

📦 インストール

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 にログを出力し、以下の詳細情報を含みます。

• サーバーの起動/停止状態
• ドローンの接続状態
• コマンドの実行状況
• クライアントの接続
• エラー条件

安全上の注意事項

• サーバーは UDP ポートをバインドするために root/sudo アクセス権が必要です。
• 認証は実装されていません（ネットワークの安全性に依存）。
• CORS はすべてのソースに対して有効化されています（*）。
• 制御された環境でのみ使用してください。

開発

サーバーは以下の技術を使用して構築されています。

• Python の mcp ライブラリを使用したプロトコル処理
• Starlette を使用した HTTP/SSE トランスポート
• Uvicorn を ASGI サーバーとして使用
• ドローンの UDP 通信にはネイティブの Python ソケットライブラリを使用

トラブルシューティング

1. サーバーが起動しない場合：
   • sudo/root アクセス権があることを確認してください。
   • Tello の WiFi が接続されていることを確認してください。
   • ポート 3000 を使用している他のプロセスがないことを確認してください。
2. ドローンに接続できない場合：
   • ドローンの電源が入っていることを確認してください。
   • WiFi 接続状態を確認してください。
   • 他のアプリケーションがドローンを制御していないことを確認してください。
3. コマンドが失敗する場合：
   • ドローンのバッテリー残量を確認してください。
   • ドローンが安全な飛行環境にあることを確認してください。
   • コマンドパラメータが許容範囲内であることを確認してください。

📄 ライセンス

MIT

貢献

貢献を歓迎します。