ArduPilot

v1.0.0Developer Toolsstable

ArduPilotドローンをAIエージェントから操作するMCPサーバーです。

ardupilotdronefastmcpmcp-serverpython
Share:
8
Stars
0
Downloads
0
Weekly
0/5

What is ArduPilot?

ArduPilot is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ardupilotドローンをaiエージェントから操作するmcpサーバーです。

ArduPilotドローンをAIエージェントから操作するMCPサーバーです。

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • ArduPilotドローンをAIエージェントから操作するMCPサーバーです。

Use Cases

Control ArduPilot drones through Claude via MCP.
Automate drone operations and flight management.
hfujikawa77

Maintainer

LicenseGPL-3.0
Languagepython
Versionv1.0.0
UpdatedMay 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx ardupilot

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use ArduPilot

The ArduPilot MCP Server lets AI agents arm, disarm, fly, and mission-plan ArduPilot-based drones through natural language. Built with FastMCP and DroneKit, it exposes flight control functions including takeoff, mode switching, GPS position retrieval, mission upload, and autonomous star-pattern flight — all controllable through Claude or any MCP client.

Prerequisites

  • Python 3.10+ with pip installed
  • ArduPilot SITL (Software In The Loop) simulator or a physical ArduPilot flight controller connected via MAVLink
  • DroneKit-Python library (installed via requirements.txt)
  • Claude Desktop or another MCP client that supports stdio transport
  • Basic understanding of MAVLink and ArduPilot flight modes (GUIDED, AUTO, etc.)
1

Clone the repository and install dependencies

Clone the ardupilot-mcp-server repository and install all Python dependencies including DroneKit and FastMCP. It is recommended to use a virtual environment to avoid conflicts with other Python packages.

git clone https://github.com/hfujikawa77/ardupilot-mcp-server.git
cd ardupilot-mcp-server
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
2

Start ArduPilot SITL for testing

If you don't have a physical drone, start the ArduPilot SITL simulator. The MCP server connects to MAVLink on the default SITL port. Run SITL in a separate terminal window before starting the MCP server.

# In a separate terminal — start ArduPilot SITL (copter)
sim_vehicle.py -v ArduCopter --map --console
3

Run the MCP server

Launch the MCP server directly. By default it connects to the MAVLink endpoint exposed by SITL or a physical controller. Keep this process running while your AI client is connected.

python ardupilot_mcp_server.py
4

Add the server to Claude Desktop

Register the server in claude_desktop_config.json using the absolute path to your Python binary inside the virtual environment and the path to the server script. The alwaysAllow list pre-authorizes safe commands so Claude does not prompt for each action.

5

Test a basic flight sequence

With Claude Desktop open and the SITL simulator running, send natural language commands to verify each step of the flight sequence works. Always confirm the vehicle is in GUIDED mode before arming.

ArduPilot Examples

Client configuration

Claude Desktop configuration that runs the ArduPilot MCP server using the virtual environment Python. Adjust the paths to match your system. The alwaysAllow list skips confirmation prompts for basic flight operations.

{
  "mcpServers": {
    "ardupilot-controller": {
      "command": "/absolute/path/to/ardupilot-mcp-server/.venv/bin/python",
      "args": ["/absolute/path/to/ardupilot-mcp-server/ardupilot_mcp_server.py"],
      "alwaysAllow": ["arm", "disarm", "takeoff", "change_mode", "get_position"]
    }
  }
}

Prompts to try

Natural language prompts covering the full range of ArduPilot MCP tools from pre-flight to mission execution.

- "Arm the aircraft and prepare for takeoff"
- "Take off to 15 meters altitude"
- "Switch to GUIDED flight mode"
- "What is the drone's current GPS position?"
- "Upload a star-shaped mission at 20 meters altitude and start it"
- "Download the current onboard mission and show me the waypoints"
- "Disarm the aircraft after landing"

Troubleshooting ArduPilot

Connection refused when the server tries to reach the MAVLink endpoint

Ensure ArduPilot SITL is running before starting the MCP server. SITL exposes MAVLink on UDP port 14550 by default. Check that no firewall blocks this port and that DroneKit is configured to connect to the correct address (typically 127.0.0.1:14550).

Arm command fails with 'pre-arm check failed'

In SITL, pre-arm checks may require GPS lock. Wait for the simulator console to show 3D GPS fix before arming, or disable specific pre-arm checks in ArduPilot parameters (e.g., ARMING_CHECK=0 for testing only).

ModuleNotFoundError for dronekit or fastmcp

Make sure you activated the virtual environment before running the server: `source .venv/bin/activate`. Also confirm the Claude Desktop config points to the Python binary inside .venv, not the system Python.

Frequently Asked Questions about ArduPilot

What is ArduPilot?

ArduPilot is a Model Context Protocol (MCP) server that ardupilotドローンをaiエージェントから操作するmcpサーバーです。 It connects AI assistants to external tools and data sources through a standardized interface.

How do I install ArduPilot?

Follow the installation instructions on the ArduPilot GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with ArduPilot?

ArduPilot works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is ArduPilot free to use?

Yes, ArduPilot is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "ardupilot": { "command": "npx", "args": ["-y", "ardupilot"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use ArduPilot?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides