Infrahub MCP server
com.opsmill/infrahub-mcp·v0.1.2·10 starsAn MCP server connects your AI assistants to Infrahub using the open MCP standard.
10 stars38 downloads/wk
Reviews
Write oneNobody has reviewed Infrahub yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Infrahub tools (10, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
branch_createwrite actionCreate a new branch in infrahub.
get_branchesRetrieve all branches from infrahub.
get_graphql_schemaRetrieve the GraphQL schema from Infrahub
get_node_filtersRetrieve all the available filters for a specific schema node kind.
get_nodesGet all objects of a specific kind from Infrahub.
get_related_nodesRetrieve related nodes by relation name and a kind.
get_schemaRetrieve the full schema for a specific kind. This includes attributes, relationships, and their types.
get_schema_mappingList all schema nodes and generics available in Infrahub
get_schemasRetrieve all schemas from Infrahub, optionally excluding Profiles and Templates.
query_graphqlwrite actionExecute a GraphQL query against Infrahub.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan26 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 4 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
How Infrahub compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 85/100
- higher than 70% of 48,255 servers
- Tools
- 10
- the typical server has 7
- Tools that change things
- 20%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 10
- more than 88% of 28,688 servers
- Downloads a week
- 38
- more than 29% of 12,191 servers with a package
What its tools let an agent do: 8 read · 2 change
Install Infrahub in Claude Code, Cursor or VS Code
claude mcp add infrahub-mcp -- uvx infrahub-mcp
What the publisher says
From the Infrahub repository's README, as published. We do not edit it. Read it on GitHub
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-mcpDocker:
docker pull registry.opsmill.io/opsmill/infrahub-mcp:latest
# or use Docker Compose:
docker compose up -dQuickstart
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-mcpStreamable HTTP (for remote clients, sidecar deployments):
infrahub-mcp --transport streamable-http --host 0.0.0.0 --port 8001What 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-); 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.
- 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.
Nothing above is checked by us. What we check is on the safety report.
Infrahub: common questions
- Is Infrahub MCP server safe?
- Yes, by our scan: it is graded A (85/100). Read the Infrahub safety report
- How do I install Infrahub?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Infrahub need an API key?
- Yes. The registry entry asks for
INFRAHUB_API_TOKEN. - Is Infrahub maintained?
- The last commit was 42 days ago (2026-09-23). The latest release is v0.1.2.
- How does Infrahub compare with other MCP servers?
- safety score 85/100 (higher than 70% of 48,255 servers); tools 10 (the typical server has 7); tools that change things 20% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.