ardupilot-mavlink-mcp — MCP-сервер для Claude Code: установка и обзор
MCP-сервер ardupilot-mavlink-mcp для Claude Code связывает агента с аппаратом на ArduPilot через протокол MAVLink в реальном времени. Включается при диагностике сбоев арминга и проверке телеметрии.
MIT ★ 5 обновлён 2026-08-03
claude mcp add ardupilot-mavlink-mcp -- uvx ardupilot-mavlink-mcpЧто делает ardupilot-mavlink-mcp
Сервер подключается к запущенному экземпляру ArduPilot по TCP, UDP или через последовательный порт. Фоновый поток собирает входящий поток телеметрии в кеш, откуда агент мгновенно читает заряд батареи, статус GPS, режим полёта и пространственное положение без блокировки канала.
Инструмент выявляет причины отказа перед взлётом: читает текстовые уведомления STATUSTEXT и код подтверждения COMMAND_ACK. Сервер умеет переключать полётные режимы по их строковым именам, читать и менять параметры с проверкой эхо-ответа PARAM_VALUE.
Любые команды на запись по умолчанию отключены. Для работы с моторами и параметрами в SITL требуется флаг --enable-actuation, а для связи с физическим бортом — дополнительный флаг --allow-real-vehicle. Изменение параметра ARMING_CHECK заблокировано на уровне кода при любых флагах. Для запуска нужен Python 3.10 или новее.
Какие задачи решает
- читать текущую телеметрию ArduPilot из кеша без блокировок
- выяснять причины отказа моторов к взлёту через журнал сообщений prearm
- изменять параметры конфигурации с подтверждением от прошивки
- переключать режимы полёта коптера или ровера по текстовому названию
Примеры запросов агенту
- Проверь телеметрию ArduPilot и покажи статус спутников и батареи
- Узнай, почему аппарат отказывается армиться, и выведи последние сообщения prearm
- Переключи режим полёта на LOITER
Как установить ardupilot-mavlink-mcp
Командой платформы
claude mcp add ardupilot-mavlink-mcp -- uvx ardupilot-mavlink-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from ardupilot-mavlink-mcp <команда>
Командой платформы
codex mcp add ardupilot-mavlink-mcp -- uvx ardupilot-mavlink-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from ardupilot-mavlink-mcp <команда>
Файл настроек
{
"mcpServers": {
"ardupilot-mavlink-mcp": {
"command": "uvx",
"args": [
"ardupilot-mavlink-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from ardupilot-mavlink-mcp <команда>
Файл настроек
{
"servers": {
"ardupilot-mavlink-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"ardupilot-mavlink-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from ardupilot-mavlink-mcp <команда>
Командой платформы
gemini mcp add ardupilot-mavlink-mcp uvx ardupilot-mavlink-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from ardupilot-mavlink-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы об ardupilot-mavlink-mcp
Как установить ardupilot-mavlink-mcp в Claude Code?
Выполните команду claude mcp add ardupilot-mavlink-mcp -- uvx ardupilot-mavlink-mcp.
Что делает ardupilot-mavlink-mcp?
Сервер транслирует MAVLink-поток аппарата в синхронные вызовы MCP, позволяя читать параметры, проверять ошибки предполётной проверки и переключать режимы.
Что нужно для работы ardupilot-mavlink-mcp?
Требуются Python от версии 3.10 и рабочий симулятор SITL либо подключение к контроллеру. Для разблокировки команд управления и записи параметров нужны флаги --enable-actuation и --allow-real-vehicle.