awx-mcp-server — MCP-сервер для Ansible AWX: запуск джобов и инвентари
Подключает AWX, AAP или Ansible Tower к ИИ-агенту: шаблоны джобов, инвентари и проекты управляются фразой в чате. Полезно, когда вся автоматизация уже лежит в AWX.
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Что делает 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, конфиги для остальных клиентов придётся собирать из тех же полей.
Какие задачи решает
- запустить шаблон джобы и дождаться результата без похода в веб-интерфейс
- посмотреть stdout упавшей джобы прямо в чате
- проверить список инвентарей и проектов перед деплоем
- дать агенту доступ к автоматизации Ansible через токен AWX
- выгрузить вывод джобы для отчёта или разбора инцидента
Примеры запросов агенту
- Покажи все шаблоны джобов в AWX и скажи, какие в последний раз падали.
- Запусти шаблон «Deploy App» с extra-vars
{"env":"prod"}и пришли статус. - Выведи stdout джобы 123 и найди там ошибку.
Как установить awx-mcp-server
Командой платформы
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 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 <команда>
Файл настроек
{
"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 <команда>
Файл настроек
{
"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 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 <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о awx-mcp-server
Как установить awx-mcp-server в Claude Code?
Добавьте сервер командой claude mcp add awx-mcp-server -e AWX_BASE_URL=<AWX_BASE_URL> -e AWX_TOKEN=<AWX_TOKEN> -e AWX_PASSWORD=<AWX_PASSWORD> -- uvx awx-mcp-server. Вариант с полным набором переменных: `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`.
Зачем нужен awx-mcp-server?
Он даёт агенту инструменты для работы с AWX, AAP и Ansible Tower: шаблоны джобов, запуск и мониторинг, проекты, инвентари. Вместо кликов в интерфейсе вы формулируете задачу текстом.
Что нужно, чтобы сервер заработал?
Адрес инстанса в AWX_BASE_URL и доступ — токен в AWX_TOKEN либо логин с паролем. Для самоподписанного сертификата задайте AWX_VERIFY_SSL.
