Infrahub MCP Server
by
Provides an MCP interface that connects AI assistants and IDE agents to Infrahub, enabling query, creation, update, and proposal of infrastructure changes through a consistent, audited workflow.
Infrahub MCP Server Overview
What is Infrahub MCP Server about?
Enables AI assistants and development‑time agents to interact with Infrahub's infrastructure data model via the Model Context Protocol. Agents can read, write (on isolated branches), and propose changes without custom glue code.
How to use Infrahub MCP Server?
Installation
- Python package:
pip install infrahub-mcporuv pip install infrahub-mcp - Docker image:
docker pull registry.opsmill.io/opsmill/infrahub-mcp:latest(or run with Docker Compose).
Running the server
- Set connection variables for the target Infrahub instance:
export INFRAHUB_ADDRESS=http://localhost:8000 export INFRAHUB_API_TOKEN=<your-token> - Start with the default stdio transport (suitable for Claude Desktop, VS Code, Cursor):
infrahub-mcp - For remote side‑car deployments, use the streamable‑http transport:
infrahub-mcp --transport streamable-http --host 0.0.0.0 --port 8001
Full client configuration details are available in the online docs.
Key Features
- Natural‑language queries over the entire Infrahub schema.
- Schema exploration via catalog, attribute maps, and GraphQL SDL exposure.
- Automatic branch isolation for all write operations (
mcp/session-YYYYMMDD-<hex>). - Human‑in‑the‑loop change approval through
propose_changes. - Full GraphQL access for any custom query or mutation.
- Supports any MCP‑compatible client (Claude Desktop, VS Code, Cursor, CLI agents, etc.).
Use Cases
- Network engineers asking an AI assistant to locate devices or interfaces.
- DevOps teams automating configuration updates through chat‑driven workflows.
- Security auditors reviewing proposed infrastructure changes before merge.
- Developers integrating IDE extensions that can fetch or modify topology data on‑the‑fly.
- CI/CD pipelines that trigger AI‑generated changes and submit them for manual approval.
FAQ
Q: Do writes affect the main branch directly? A: No. All writes are performed on an auto‑created session branch and require explicit approval to merge.
Q: Which clients are compatible? A: Any client implementing the Model Context Protocol, including Claude Desktop, VS Code extensions, Cursor, and custom CLI agents.
Q: How is authentication handled?
A: Provide an Infrahub API token via INFRAHUB_API_TOKEN. Additional authentication modes are documented online.
Q: Can I run the server in a containerized environment? A: Yes. Use the official Docker image or Docker Compose as described in the README.
Q: Is there a way to execute arbitrary GraphQL queries?
A: The run_graphql method allows execution of any GraphQL query or mutation against the Infrahub API.
Infrahub MCP Server's 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):
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_changesto 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.
- Installation and client setup
- Docker / sidecar deployment
- Authentication modes
- Configuration reference
- Methods reference — tools, resources, prompts
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.
Infrahub MCP Server Reviews
Login Required
Please log in to share your review and rating for this MCP.
Similar MCP Servers like Infrahub MCP Server
Explore related MCPs that share similar capabilities and solve comparable challenges
Sequential Thinking
Officialby modelcontextprotocol
An MCP server implementation that provides a tool for dynamic and reflective problem-solving through a structured thinking process.
PrivateGPT
by zylon-ai
Provides an open-source API layer that enables local OpenAI‑compatible models to be used for production AI applications, offering standardized message handling, document ingestion, retrieval‑augmented generation, tool integration, and MCP connectivity.
LibreChat
OfficialClientby danny-avila
Provides a self‑hosted ChatGPT‑style interface supporting numerous AI models, agents, code interpreter, image generation, multimodal interactions, and secure multi‑user authentication.
Goose
by block
Automates engineering tasks on local machines, executing code, building projects, debugging, orchestrating workflows, and interacting with external APIs using any LLM.
Roo Code
OfficialClientby RooCodeInc
Provides an autonomous AI coding partner inside the editor that can understand natural language, manipulate files, run commands, browse the web, and be customized via modes and instructions.
Pydantic AI
by pydantic
A Python framework that enables seamless integration of Pydantic validation with large language models, providing type‑safe agent construction, dependency injection, and structured output handling.
Mcp Use
Clientby mcp-use
A Python SDK that simplifies interaction with MCP servers and enables developers to create custom agents with tool‑calling capabilities.
Mcp Agent
Clientby lastmile-ai
Build effective agents using Model Context Protocol and simple, composable workflow patterns.
Klavis AI
Officialby Klavis-AI
Provides production‑ready MCP servers and a hosted service for integrating AI applications with over 50 third‑party services via standardized APIs, OAuth, and easy Docker or hosted deployment.