Skip to content
MCP server

Ardupilot MCP

Diagnose ArduPilot flight logs (.bin and .tlog) and explain what went wrong

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.0.0
Listing updated
today

Similar MCP servers

About Ardupilot MCP

Ardupilot MCP is an open-source MCP server for engineering simulation. It runs locally on your machine and is started by your AI client.

Give an assistant a .bin or .tlog flight log and it explains in plain language what happened in the flight: vibration, low battery, GPS loss, motor loss or bad settings. Findings come from deterministic checks, each with its threshold sourced in the project's documentation, and the model only explains them. The server reads local files only, never connects to the network, never sends commands to the vehicle and never writes parameters.

There are twelve read-only tools. The analyser returns findings ranked by severity with links to official ArduPilot docs, a timeline tool finds the first anomaly and the moment of impact without claiming cause and effect, and a forum-report tool drafts Markdown for discuss.ardupilot.org without GPS positions. Others compare two flights, summarise the vehicle and its profile, list events, query raw time series and read parameter files, plus tuning suggestions for notch filters, PID and autotune that are never applied.

The README is in Turkish with an English version, and says 18 checks are measured against 49 real crash logs from the forum. Known limits include no detection of compass-induced toilet-bowl drift, and .tlog files give coarser diagnosis. It is AGPL-3.0, run with uvx.

Install

Run in a terminal

claude mcp add ardupilot-mcp -- uvx ardupilot-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ardupilot-mcp": {
      "command": "uvx",
      "args": [
        "ardupilot-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ardupilot-mcp": {
      "command": "uvx",
      "args": [
        "ardupilot-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ardupilot-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ardupilot-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ardupilot-mcp": {
      "command": "uvx",
      "args": [
        "ardupilot-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ardupilot-mcp": {
      "command": "uvx",
      "args": [
        "ardupilot-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

analyze_log
Run all checks and return ranked findings
incident_timeline
First anomaly and impact with event timeline
forum_report
Markdown report for the ArduPilot forum
compare_logs
Compare parameters, firmware and metrics between flights
log_summary
Vehicle, firmware, duration, modes and log integrity
vehicle_profile
Frame, motors, battery, hover throttle and power margin
list_events
Timeline of ERR, MODE, EV and MSG records
query_timeseries
Raw series behind a finding
get_params
Parameters with documented range, units and values
load_param_file
Read an exported .param file
recommend_tuning
Notch, PID and autotune suggestions, not applied
list_checks
List registered checks

What it does

Deterministic checks
Eighteen checks produce sourced findings; the model only explains them.
Incident timeline
Finds the first anomaly and impact time without asserting cause.
Forum report
Drafts a Markdown post for the ArduPilot forum without GPS location.
Log comparison
Compares parameters, firmware and metrics between two flights.
Tuning advice
Suggests harmonic notch, PID and autotune settings without applying them.
Read-only and local
Reads local files only and never sends commands to the vehicle.

Good for

  • Work out why a drone crashed from its log
  • Spot vibration or battery problems before the next flight
  • Compare logs before and after a parameter change
  • Prepare a forum post asking for crash analysis help

Pricing

Open source

Free, AGPL-3.0; commercial licence on request

Ardupilot MCP FAQ

Which log files work?

Both .bin and .tlog; .bin gives the more detailed diagnosis.

Can it control my vehicle?

No. It reads local files only, sends no commands and writes no parameters.

How accurate is it?

The README says the engine is scored on 49 real crash logs from the forum; some cases such as toilet-bowl drift are not yet detected.

What licence does it use?

AGPL-3.0, with a commercial licence available on request.

Is Ardupilot MCP free?

Yes. Ardupilot MCP is open source, so you can use and self-host it for free.

How do I add Ardupilot MCP to Claude Code?

Run this command in your terminal: claude mcp add ardupilot-mcp -- uvx ardupilot-mcp

What are the best alternatives to Ardupilot MCP?

The closest alternatives to Ardupilot MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers