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.