English Français العربية

com.opsmill/infrahub-mcp

Official registry AI and agents

An MCP server connects your AI assistants to Infrahub using the open MCP standard.

Source code Documentation

What can you do with com.opsmill/infrahub-mcp?

  • 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.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package infrahub-mcp
Claude Code 
claude mcp add infrahub-mcp -e 'INFRAHUB_ADDRESS=<INFRAHUB_ADDRESS>' -e 'INFRAHUB_API_TOKEN=<your infrahub_api_token>' -- uvx infrahub-mcp==0.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "infrahub-mcp": {
            "command": "uvx",
            "args": [
                "infrahub-mcp==0.1.2"
            ],
            "env": {
                "INFRAHUB_ADDRESS": "<INFRAHUB_ADDRESS>",
                "INFRAHUB_API_TOKEN": "<your infrahub_api_token>"
            }
        }
    }
}

Environment variables

  • INFRAHUB_ADDRESS required The URL/address of your Infrahub instance
  • INFRAHUB_API_TOKEN required secret Your Infrahub API token for authentication

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Infrahub MCP Server
  2. Installation
  3. Quickstart
  4. What you can do with it
  5. Documentation
  6. About Infrahub
  7. License

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

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.

Documentation

Full documentation, including client configuration for Cursor, VS Code, Claude Desktop, and Claude Code, is available at the Infrahub MCP Server docs site.

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.

License

Apache 2.0 — see LICENSE.

Frequently asked questions

What is com.opsmill/infrahub-mcp?

An MCP server connects your AI assistants to Infrahub using the open MCP standard.

How do I install com.opsmill/infrahub-mcp?

It runs on your machine. In Claude Code: claude mcp add infrahub-mcp -e 'INFRAHUB_ADDRESS=<INFRAHUB_ADDRESS>' -e 'INFRAHUB_API_TOKEN=<your infrahub_api_token>' -- uvx infrahub-mcp==0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.opsmill/infrahub-mcp need an API key?

Yes. It expects INFRAHUB_ADDRESS, INFRAHUB_API_TOKEN, which you set in its configuration.

Is com.opsmill/infrahub-mcp open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains com.opsmill/infrahub-mcp?

It is published by opsmill. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.