# Ardupilot MCP

> Ardupilot MCP is an open-source MCP server for engineering simulation. Diagnose ArduPilot flight logs (.bin and .tlog) and explain what went wrong. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/furkanisikay/ardupilot-mcp
- **MCP Registry name:** io.github.furkanisikay/ardupilot-mcp
- **Categories:** [engineering simulation](https://ai-powered.com/categories/engineering-simulation), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add ardupilot-mcp -- uvx ardupilot-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/ardupilot-mcp
