MCP Server

Name: MCP Server
Author: Real-Time-Robotics

@Real-Time-Robotics

リポジトリ

MCP Server について

概要はまだありません

基本情報

カテゴリ

その他

ランタイム

python

トランスポート

stdio

公開者

Real-Time-Robotics

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "rtr-mcp-server": {
      "command": "python3",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is MCP Server?

MCP Server is a lightweight wrapper around DroneKit that exposes drone vehicle APIs as asynchronous MCP tools over HTTP (SSE) or messaging. It connects to a DroneKit Vehicle, registers flight‑controller operations as MCP tools, and allows clients like Claude Desktop to send text commands or JSON payloads to control the drone.

How to use MCP Server?

Clone the repository, create a Python virtual environment (3.8+), install dependencies from requirement.txt, and create a .env file with DRONE_CONN (MAVLink connection string) and GOOGLE_MAPS_API_KEY. Run mcp_server.py; it listens on http://0.0.0.0:8080 by default. Configure Claude Desktop by setting the command and argument fields in claude_desktop_config.json using the paths from which python and pwd.

Key features of MCP Server

Exposes arm, takeoff, land, and mode switching tools
Retrieves global and local position, home location, and distance to home
Returns attitude, battery status, and full vehicle status summary
Supports mission upload and set home operations
Works over HTTP/SSE with DroneKit and ArduPilot SITL
Integrates with Claude Desktop for natural‑language drone control

Use cases of MCP Server

Control a quadcopter in ArduPilot SITL from Claude Desktop
Automate takeoff, waypoint navigation, and landing via MCP tools
Retrieve real‑time telemetry (position, battery, attitude) for monitoring
Upload and execute survey or custom missions on a physical drone
Debug API exceptions with built‑in exception info tool

FAQ from MCP Server

What are the prerequisites to run MCP Server?

Python 3.8+, a .env file with DRONE_CONN (e.g., tcp:192.168.2.129:5763) and a Google Maps API key with Geocoding enabled, and an internet connection. macOS users need a Linux VM (e.g., Ubuntu in VMware Fusion) to run ArduPilot SITL.

How does the MCP Server communicate?

It runs a FastMCP server on http://0.0.0.0:8080 that exposes tools over SSE (Server‑Sent Events) and HTTP. Clients send simple text commands or JSON payloads to invoke the MCP tools.

What drone platforms are supported?

ArduPilot SITL running on Linux or inside a macOS VM (Ubuntu 20.04+ recommended). Real hardware is supported via any MAVLink connection string (tcp:, udp:, serial) that DroneKit can handle.

Do I need a Google Maps API key?

Yes. The GOOGLE_MAPS_API_KEY environment variable is required for geocoding features. The API key must have the Geocoding API enabled in the Google Cloud Console.

What MCP tools are available?

Tools include arm(), takeoff(altitude), land(), set_home(), location_global(), location_global_relative(), home_location(), get_location_local(), distance_home(), switch_mode(mode), status(), api_exception_info(), get_attitude(), and get_battery(). See the README for full signatures.