MCP Server

Name: MCP Server
Author: Real-Time-Robotics

@Real-Time-Robotics

Repository

About MCP Server

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.