infrahub-mcp — MCP-сервер для Claude Code: доступ к Infrahub
Подключает ИИ-ассистента к Infrahub, чтобы искать устройства и IP-адреса запросами на естественном языке. Записи уходят на отдельную ветку и ждут подтверждения.
claude mcp add infrahub-mcp -e INFRAHUB_ADDRESS=<INFRAHUB_ADDRESS> -e INFRAHUB_API_TOKEN=<INFRAHUB_API_TOKEN> -- uvx infrahub-mcpЧто делает infrahub-mcp
Сервер даёт агенту доступ к вашей инфраструктурной базе Infrahub: он ищет устройства, интерфейсы и IP-адреса по атрибутам и частичному совпадению, показывает схему, карты атрибутов и фильтров по каждому типу, а также GraphQL SDL как ресурсы MCP. Если готовых инструментов мало, можно выполнить произвольный GraphQL-запрос или мутацию.
Записи не попадают в основную ветку. Сервер сам создаёт сессионную ветку вида mcp/session-YYYYMMDD-<hex>, а для слияния нужно вызвать propose_changes и открыть Proposed Change на проверку человеком. Это удобно, когда правки в топологию или IP-пространство делает агент, а не инженер.
Перед запуском задайте INFRAHUB_ADDRESS и INFRAHUB_API_TOKEN — без них сервер не подключится к инстансу. Транспорт по умолчанию stdio, для удалённых клиентов есть streamable HTTP с флагами --transport streamable-http --host 0.0.0.0 --port 8001. Ставится через pip install infrahub-mcp или uv pip install infrahub-mcp, есть образ registry.opsmill.io/opsmill/infrahub-mcp:latest.
Какие задачи решает
- найти устройство или интерфейс по части имени прямо в диалоге с агентом
- посмотреть схему Infrahub и доступные фильтры, не открывая отдельную панель
- внести правки в топологию на изолированной ветке
- отправить изменения на ревью через Proposed Change
- выполнить свой GraphQL-запрос к API Infrahub
Примеры запросов агенту
- Найди в Infrahub все интерфейсы со скоростью 100G на устройстве
edge-01 - Создай на сессионной ветке новый IP-префикс и предложи изменения на ревью
- Покажи схему для типа устройства и какие у него есть фильтры
Как установить infrahub-mcp
Командой платформы
claude mcp add infrahub-mcp -e INFRAHUB_ADDRESS=<INFRAHUB_ADDRESS> -e INFRAHUB_API_TOKEN=<INFRAHUB_API_TOKEN> -- uvx infrahub-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from infrahub-mcp <команда>
Командой платформы
codex mcp add infrahub-mcp --env INFRAHUB_ADDRESS=<INFRAHUB_ADDRESS> --env INFRAHUB_API_TOKEN=<INFRAHUB_API_TOKEN> -- uvx infrahub-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from infrahub-mcp <команда>
Файл настроек
{
"mcpServers": {
"infrahub-mcp": {
"command": "uvx",
"args": [
"infrahub-mcp"
],
"env": {
"INFRAHUB_ADDRESS": "<INFRAHUB_ADDRESS>",
"INFRAHUB_API_TOKEN": "<INFRAHUB_API_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from infrahub-mcp <команда>
Файл настроек
{
"servers": {
"infrahub-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"infrahub-mcp"
],
"env": {
"INFRAHUB_ADDRESS": "<INFRAHUB_ADDRESS>",
"INFRAHUB_API_TOKEN": "<INFRAHUB_API_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from infrahub-mcp <команда>
Командой платформы
gemini mcp add -e INFRAHUB_ADDRESS=<INFRAHUB_ADDRESS> -e INFRAHUB_API_TOKEN=<INFRAHUB_API_TOKEN> infrahub-mcp uvx infrahub-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from infrahub-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о infrahub-mcp
Как установить infrahub-mcp в Claude Code?
Одной командой: claude mcp add infrahub-mcp -e INFRAHUB_ADDRESS=<INFRAHUB_ADDRESS> -e INFRAHUB_API_TOKEN=<INFRAHUB_API_TOKEN> -- uvx infrahub-mcp. Подставьте адрес своего инстанса Infrahub и токен API.
Что делает infrahub-mcp?
Соединяет ИИ-ассистента с Infrahub по протоколу MCP: агент ищет данные инфраструктуры, читает схему и может предложить изменения. Записи идут на отдельную ветку и требуют подтверждения перед слиянием.
Что нужно для работы infrahub-mcp?
Адрес инстанса Infrahub и токен API — они передаются через INFRAHUB_ADDRESS и INFRAHUB_API_TOKEN. Запуск возможен по stdio или по streamable HTTP.
