# awx-mcp-server

Подключает AWX, AAP или Ansible Tower к ИИ-агенту: шаблоны джобов, инвентари и проекты управляются фразой в чате. Полезно, когда вся автоматизация уже лежит в AWX.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14
- Автор: SurgeX-Labs
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/SurgeX-Labs/awx-mcp-server
- Обновлён: 2026-02-23
- HTML: https://affpapa.org/nevibecode/mcp/awx-mcp-server

## Что делает

Сервер работает по STDIO и отдаёт агенту операции над шаблонами джобов, запуском и мониторингом джобов, проектами и инвентарями. То есть агент может сам запустить деплой или посмотреть вывод упавшей джобы, не переключаясь в веб-интерфейс AWX.

Внутри — Python-пакет, ставится через `uvx awx-mcp-server`. Кроме сервера в репозитории есть CLI (`awx-mcp-server jobs launch`, `awx-mcp-server templates list`), REST API и вариант запуска в Docker или Kubernetes для команды. Это только варианты по документации автора; для работы с агентом хватает STDIO-режима.

Перед подключением нужны адрес инстанса и токен — `AWX_BASE_URL` и `AWX_TOKEN` (либо пара `AWX_USERNAME` с `AWX_PASSWORD`), а также `AWX_VERIFY_SSL` для самоподписанных сертификатов. Без рабочего адреса AWX сервер не подключится, так что сначала проверьте доступ к API инстанса из своей машины. Документация покрывает в первую очередь VS Code и Copilot Chat, конфиги для остальных клиентов придётся собирать из тех же полей.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `AWX_BASE_URL`, `AWX_TOKEN`, `AWX_USERNAME`, `AWX_PASSWORD`, `AWX_VERIFY_SSL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env AWX_BASE_URL=<AWX_BASE_URL> --env AWX_TOKEN=<AWX_TOKEN> --env AWX_USERNAME=<AWX_USERNAME> --env AWX_PASSWORD=<AWX_PASSWORD> --env AWX_VERIFY_SSL=<AWX_VERIFY_SSL> --transport stdio awx-mcp-server -- uvx awx-mcp-server
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from awx-mcp-server <команда>

### Codex

**Командой платформы**
```bash
codex mcp add awx-mcp-server --env AWX_BASE_URL=<AWX_BASE_URL> --env AWX_TOKEN=<AWX_TOKEN> --env AWX_USERNAME=<AWX_USERNAME> --env AWX_PASSWORD=<AWX_PASSWORD> --env AWX_VERIFY_SSL=<AWX_VERIFY_SSL> -- uvx awx-mcp-server
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from awx-mcp-server <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "awx-mcp-server": {
            "command": "uvx",
            "args": [
                "awx-mcp-server"
            ],
            "env": {
                "AWX_BASE_URL": "<AWX_BASE_URL>",
                "AWX_TOKEN": "<AWX_TOKEN>",
                "AWX_USERNAME": "<AWX_USERNAME>",
                "AWX_PASSWORD": "<AWX_PASSWORD>",
                "AWX_VERIFY_SSL": "<AWX_VERIFY_SSL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from awx-mcp-server <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "awx-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "awx-mcp-server"
            ],
            "env": {
                "AWX_BASE_URL": "<AWX_BASE_URL>",
                "AWX_TOKEN": "<AWX_TOKEN>",
                "AWX_USERNAME": "<AWX_USERNAME>",
                "AWX_PASSWORD": "<AWX_PASSWORD>",
                "AWX_VERIFY_SSL": "<AWX_VERIFY_SSL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from awx-mcp-server <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e AWX_BASE_URL=<AWX_BASE_URL> -e AWX_TOKEN=<AWX_TOKEN> -e AWX_USERNAME=<AWX_USERNAME> -e AWX_PASSWORD=<AWX_PASSWORD> -e AWX_VERIFY_SSL=<AWX_VERIFY_SSL> awx-mcp-server uvx awx-mcp-server
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from awx-mcp-server <команда>

## Когда брать
- запустить шаблон джобы и дождаться результата без похода в веб-интерфейс
- посмотреть stdout упавшей джобы прямо в чате
- проверить список инвентарей и проектов перед деплоем
- дать агенту доступ к автоматизации Ansible через токен AWX
- выгрузить вывод джобы для отчёта или разбора инцидента

## Примеры запросов агенту
- Покажи все шаблоны джобов в AWX и скажи, какие в последний раз падали.
- Запусти шаблон «Deploy App» с extra-vars `{"env":"prod"}` и пришли статус.
- Выведи stdout джобы 123 и найди там ошибку.

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23643
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Coder](https://affpapa.org/nevibecode/mcp/coder.md) — MCP-сервер · ★ 17160
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12109

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