FPV Drone MCP Platform

A suite of three Model Context Protocol servers that give AI assistants (Claude, etc.) direct control over FPV drone hardware: radio transmitter configuration, flight controller tuning, and blackbox log analysis.

Claude ──MCP──┬── betaflight-mcp        ──USB/Serial──► Flight Controller
              ├── tango2-mcp-server     ──SD Card────► TBS Tango 2 Radio
              └── blackbox-mcp-server   ──Filesystem──► Blackbox Logs

Architecture

Total: 87 tools across 3 servers, ~8,600 lines of code.

---

betaflight-mcp

Communicates with Betaflight flight controllers over USB serial using the MSP protocol. Supports full configuration, telemetry, and fleet management.

Location: MCP/

Capabilities

• Connection: Auto-detect FC, connect/disconnect/reconnect with retry
• PID Tuning: Read/write PID settings, RC rates, filter config
• Modes & Switches: Configure AUX modes (ARM, ANGLE, HORIZON, etc.)
• OSD: Full OSD layout editing with presets (freestyle, long range, racing)
• VTX: Band, channel, power, pit mode control
• GPS: GPS status monitoring, GPS Rescue configuration
• Safety: Preflight checks, motor test (individual), emergency stop, beeper
• Fleet Management: Register multiple drones, backup all configs, compare settings
• Sensors: Live IMU data, attitude, battery status, RC channels, motor values
• CLI: Send raw Betaflight CLI commands, backup/restore via diff

Handler Modules

MCP/src/betaflight_mcp/
├── server.py          # MCP server + tool definitions + dispatch
├── msp.py             # MSP protocol implementation (v1)
└── handlers/
    ├── connection.py  # Serial port management
    ├── config.py      # PIDs, rates, filters, features, failsafe
    ├── sensors.py     # IMU, attitude, battery, RC, motors
    ├── safety.py      # Preflight, motor test, stop, calibration
    ├── fleet.py       # Multi-drone registry and bulk operations
    ├── osd.py         # OSD layout, elements, presets
    ├── vtx.py         # Video transmitter settings
    └── gps.py         # GPS status and rescue config

Setup

cd MCP
python -m venv venv
source venv/bin/activate
pip install -e .

MCP Config

{
  "mcpServers": {
    "betaflight": {
      "command": "MCP/venv/bin/python",
      "args": ["-m", "betaflight_mcp"]
    }
  }
}

Environment Variables