# ardupilot-mavlink-mcp

ardupilot-mavlink-mcp is an MCP server for Claude Code that connects an AI agent to an ArduPilot vehicle via MAVLink. Inspects live telemetry and troubleshoots prearm issues.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: rmeadomavic
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rmeadomavic/ardupilot-mcp
- Updated: 2026-08-03
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/ardupilot-mavlink-mcp

## What it does

The server connects to an ArduPilot instance over TCP, UDP, or serial connections. A dedicated reader thread collects the MAVLink stream and caches telemetry, allowing the agent to retrieve orientation, battery level, GPS fixes, and flight modes without blocking the connection.

It handles live prearm troubleshooting by reading incoming `STATUSTEXT` notices and the returned `COMMAND_ACK` responses directly from the link. The tool also looks up and updates flight parameters against echoed `PARAM_VALUE` confirmations and changes vehicle modes by name.

All actuation tools stay disabled by default. Modifying parameters, switching modes, or arming in SITL demands the `--enable-actuation` flag. Interacting with actual hardware also requires passing `--allow-real-vehicle`. Writing to `ARMING_CHECK` is rejected unconditionally. The server runs on Python 3.10 or newer.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add ardupilot-mavlink-mcp -- uvx ardupilot-mavlink-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from ardupilot-mavlink-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add ardupilot-mavlink-mcp -- uvx ardupilot-mavlink-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from ardupilot-mavlink-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ardupilot-mavlink-mcp": {
            "command": "uvx",
            "args": [
                "ardupilot-mavlink-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from ardupilot-mavlink-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ardupilot-mavlink-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "ardupilot-mavlink-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from ardupilot-mavlink-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add ardupilot-mavlink-mcp uvx ardupilot-mavlink-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from ardupilot-mavlink-mcp <command>

## When to use it
- Inspect live ArduPilot telemetry data from an asynchronous link cache
- Identify why a vehicle refuses to arm using real-time prearm status logs
- Update autopilot parameters confirmed via echoed parameter messages
- Switch vehicle flight modes by name across ArduCopter and other variants

## Example prompts
- Check the ArduPilot link status and show current battery voltage
- Read recent statustext messages to explain why arming failed
- Switch the current flight mode to GUIDED

## Similar
- [drone-cv-expert](https://affpapa.org/en/nevibecode/skills/drone-cv-expert.md) — skill · 259 installs
- [muapi-drone-style-video](https://affpapa.org/en/nevibecode/skills/muapi-drone-style-video.md) — skill · 669 installs
- [drone-site-survey](https://affpapa.org/en/nevibecode/skills/drone-site-survey.md) — skill · 141 installs
- [Bagel](https://affpapa.org/en/nevibecode/mcp/bagel.md) — MCP server · ★ 407 repo stars
- [gws-apps-script](https://affpapa.org/en/nevibecode/commands/gws-apps-script.md) — command · 72 installs
- [skill-share](https://affpapa.org/en/nevibecode/skills/skill-share.md) — skill · 71 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
