infrahub-mcp

本地服务

github.com/opsmill云与基础设施101 天前更新

代码仓库

关于 infrahub-mcp

infrahub-mcp 将 AI 助手和 IDE Agent 连接到 Infrahub 基础设施数据，支持查询及受控变更，并在合并前要求人工审核。

主要功能

01查询和筛选基础设施数据
02探索架构及 GraphQL SDL 资源
03在隔离分支写入变更
04提交变更提案以供审批
05执行 GraphQL 查询和变更

适用场景

01用自然语言查找设备或 IP 地址
02在对话中检查 Infrahub 架构
03准备基础设施更新并交由人工审核

MCP 相关

该 MCP 服务向客户端提供 Infrahub 数据和架构资源，以及查询、写入、提交变更提案和执行 GraphQL 的工具。支持 stdio 和 Streamable HTTP 传输。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "com-opsmill-infrahub": {
      "command": "uvx",
      "args": [
        "infrahub-mcp"
      ],
      "env": {
        "INFRAHUB_ADDRESS": "<INFRAHUB_ADDRESS>",
        "INFRAHUB_API_TOKEN": "<INFRAHUB_API_TOKEN>"
      }
    }
  }
}

启动命令uvx infrahub-mcp

需要配置的环境变量

INFRAHUB_ADDRESSThe URL/address of your Infrahub instance

INFRAHUB_API_TOKEN密钥Your Infrahub API token for authentication

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiinfrahub-mcp0.1.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Infrahub MCP 服务

Infrahub MCP 服务通过开放的 Model Context Protocol 标准，将 AI 助手和 IDE Agent 连接到 Infrahub，让 Agent 能够通过一致且经过审计的接口查询、创建、更新基础设施数据并提出变更。它适用于任何兼容 MCP 的客户端（Claude Desktop、VS Code、Cursor、命令行 Agent 等），无需编写自定义粘合代码。

所有写入操作都在独立分支中进行，并且必须经过人工批准才能合并；Agent 永远不会直接修改默认分支。

安装

pip install infrahub-mcp
# or
uv pip install infrahub-mcp

Docker：

docker pull registry.opsmill.io/opsmill/infrahub-mcp:latest
# or use Docker Compose:
docker compose up -d

快速入门

通过环境变量将服务指向你的 Infrahub 实例，然后根据客户端的要求使用相应的传输方式运行。

stdio（默认 — 适用于 Claude Desktop、VS Code、Cursor）：

export INFRAHUB_ADDRESS=http://localhost:8000
export INFRAHUB_API_TOKEN=<your-token>
infrahub-mcp

Streamable HTTP（适用于远程客户端、边车部署）：

infrahub-mcp --transport streamable-http --host 0.0.0.0 --port 8001

你可以用它做什么

用自然语言查询基础设施数据 — 查找设备、接口、IP 地址或架构中的任何类型，并按属性筛选和进行部分匹配搜索。
无需离开对话即可探索架构 — 服务通过 MCP 资源提供目录、按类型划分的属性／筛选器映射，以及 GraphQL SDL。
在独立分支上进行变更 — 写入内容会进入自动创建的会话分支（mcp/session-YYYYMMDD-<hex>）；绝不会直接触碰默认分支。
提交变更供人工审核 — 调用 propose_changes，创建提议变更，待批准后再合并。
运行任意 GraphQL — 需要完全控制时，可对 Infrahub API 执行任意查询或变更。

文档

完整文档（包括 Cursor、VS Code、Claude Desktop 和 Claude Code 的客户端配置）请参阅 Infrahub MCP Server 文档站点。

关于 Infrahub

Infrahub 是由 OpsMill 开发的开源基础设施数据管理和自动化平台（AGPLv3）。它为基础设施和网络团队提供统一的、由架构驱动的事实来源，涵盖设备、拓扑、IP 地址空间和配置，并内置版本控制、用于自动化的生成器框架，以及与 Git、Ansible、Terraform 和 CI/CD 流水线的原生集成。