com.opsmill/infrahub-mcp MCP Server

Infrahub MCP Server connects AI assistants and IDE agents to Infrahub using the open Model Context Protocol (MCP) standard. Through a consistent, audited interface, agents can query infrastructure data, create and update records, and propose changes.

🛠️ Key Features

Open MCP standard integration with Infrahub
Query, create, update, and propose changes to infrastructure data
Audited interface for infrastructure data operations
Branch-isolated writes with human approval before merging (no direct default-branch modification)

🚀 Use Cases

Let MCP-compatible clients (e.g., Claude Desktop, VS Code, Cursor, CLI agents) interact with Infrahub
Assist infrastructure data management via consistent agent actions

⚡ Developer Benefits

Works with any MCP-compatible client without custom glue code
Safer change workflow via branch isolation and human approval

⚠️ Limitations

Writes do not directly modify the default branch; merging requires human approval

Topics

agent, ai, coding-agent, infrahub, infrastructure, llm, mcp-server, network, sot, claude-code

Infrahub MCP Server

Infrahub MCP Server connects AI assistants and IDE agents to Infrahub using the open Model Context Protocol standard — so agents can query, create, update, and propose changes to your infrastructure data through a consistent, audited interface. It works with any MCP-compatible client (Claude Desktop, VS Code, Cursor, CLI agents, and more) with no custom glue code required.

All writes are branch-isolated and require human approval before merging — agents never modify your default branch directly.

Quickstart

Point the server at your Infrahub instance via environment variables, then run it over the transport your client expects.

stdio (default — for Claude Desktop, VS Code, Cursor):

bash

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

Streamable HTTP (for remote clients, sidecar deployments):

bash

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

What you can do with it

Query your infrastructure data from natural language — find devices, interfaces, IP addresses, or any kind in your schema, with attribute filtering and partial-match search.

Explore your schema without leaving the conversation — the server exposes your catalog, per-kind attribute/filter maps, and the GraphQL SDL as MCP resources.

Make changes on isolated branches — writes land on an auto-created session branch (mcp/session-YYYYMMDD-<hex>); the default branch is never touched directly.

Submit changes for human review — call propose_changes to open a Proposed Change for approval before merging.

Run arbitrary GraphQL — execute any query or mutation against the Infrahub API when you need full control.

About Infrahub

Infrahub is an open source infrastructure data management and automation platform (AGPLv3), developed by OpsMill. It gives infrastructure and network teams a unified, schema-driven source of truth — devices, topology, IP space, configuration — with built-in version control, a generator framework for automation, and native integrations with Git, Ansible, Terraform, and CI/CD pipelines.

Install

Configuration

Environment variables

INFRAHUB_ADDRESSrequired

The URL/address of your Infrahub instance

INFRAHUB_API_TOKENrequiredsecret

Your Infrahub API token for authentication

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

com.opsmill/infrahub-mcp