opsmill avatar

Infrahub Mcp

opsmill/infrahub-mcp

Connects Claude and other MCP clients to your Infrahub infrastructure database so agents can query devices, interfaces, IP addresses, and any schema kind using natural language or raw GraphQL. All writes land on isolated session branches and require a human approved Proposed Change before merging to default. You get tools for CRUD operations, schema introspection as MCP resources, and filtering with partial match search. Works over stdio for desktop clients or streamable HTTP for remote deployments. Reach for this when you want AI assisted infrastructure queries and change proposals without giving agents direct write access to your source of truth.

GitHub stars
9
tool
1
auth
Secret needed
transport
STDIO
env vars
2
last updated
Oct 10, 2025

Tools

1 tools

Public tool metadata for what this MCP can expose to an agent.

propose_changesOpens a Proposed Change for human approval before merging.

Opens a Proposed Change for human approval before merging.

No parameter schema in public metadata yet.

Sponsors

Configuration

INFRAHUB_ADDRESS*

The URL/address of your Infrahub instance

INFRAHUB_API_TOKEN*secret

Your Infrahub API token for authentication

Readme

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.

Installation

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

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):

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

Streamable HTTP (for remote clients, sidecar deployments):


View the full README on GitHub

Details

Repository
github.com/opsmill/infrahub-mcp
Package
infrahub-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active