# ardupilot-mavlink-mcp

MCP-сервер ardupilot-mavlink-mcp для Claude Code связывает агента с аппаратом на ArduPilot через протокол MAVLink в реальном времени. Включается при диагностике сбоев арминга и проверке телеметрии.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 у репозитория
- Автор: rmeadomavic
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/rmeadomavic/ardupilot-mcp
- Обновлён: 2026-08-03
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/ardupilot-mavlink-mcp

## Что делает

Сервер подключается к запущенному экземпляру ArduPilot по TCP, UDP или через последовательный порт. Фоновый поток собирает входящий поток телеметрии в кеш, откуда агент мгновенно читает заряд батареи, статус GPS, режим полёта и пространственное положение без блокировки канала.

Инструмент выявляет причины отказа перед взлётом: читает текстовые уведомления `STATUSTEXT` и код подтверждения `COMMAND_ACK`. Сервер умеет переключать полётные режимы по их строковым именам, читать и менять параметры с проверкой эхо-ответа `PARAM_VALUE`.

Любые команды на запись по умолчанию отключены. Для работы с моторами и параметрами в SITL требуется флаг `--enable-actuation`, а для связи с физическим бортом — дополнительный флаг `--allow-real-vehicle`. Изменение параметра `ARMING_CHECK` заблокировано на уровне кода при любых флагах. Для запуска нужен Python 3.10 или новее.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add ardupilot-mavlink-mcp -- uvx ardupilot-mavlink-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from ardupilot-mavlink-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add ardupilot-mavlink-mcp -- uvx ardupilot-mavlink-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from ardupilot-mavlink-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ardupilot-mavlink-mcp": {
            "command": "uvx",
            "args": [
                "ardupilot-mavlink-mcp"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from ardupilot-mavlink-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "ardupilot-mavlink-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "ardupilot-mavlink-mcp"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from ardupilot-mavlink-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add ardupilot-mavlink-mcp uvx ardupilot-mavlink-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from ardupilot-mavlink-mcp <команда>

## Когда брать
- читать текущую телеметрию ArduPilot из кеша без блокировок
- выяснять причины отказа моторов к взлёту через журнал сообщений prearm
- изменять параметры конфигурации с подтверждением от прошивки
- переключать режимы полёта коптера или ровера по текстовому названию

## Примеры запросов агенту
- Проверь телеметрию ArduPilot и покажи статус спутников и батареи
- Узнай, почему аппарат отказывается армиться, и выведи последние сообщения prearm
- Переключи режим полёта на LOITER

## Похожие
- [drone-cv-expert](https://affpapa.org/nevibecode/skills/drone-cv-expert.md) — скилл · 259 установок
- [muapi-drone-style-video](https://affpapa.org/nevibecode/skills/muapi-drone-style-video.md) — скилл · 669 установок
- [drone-site-survey](https://affpapa.org/nevibecode/skills/drone-site-survey.md) — скилл · 141 установка
- [Bagel](https://affpapa.org/nevibecode/mcp/bagel.md) — MCP-сервер · ★ 407 у репозитория
- [gws-apps-script](https://affpapa.org/nevibecode/commands/gws-apps-script.md) — команда · 72 установки
- [skill-share](https://affpapa.org/nevibecode/skills/skill-share.md) — скилл · 71 установка

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
