com.opsmill/infrahub-mcp
An MCP server connects your AI assistants to Infrahub using the open MCP standard.
Open source Open in the app JSON README (API)
About
An MCP server connects your AI assistants to Infrahub using the open MCP standard.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- com.opsmill
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.2
- Stars
- 10
- Forks
- 4
- Open pull requests
- 5
- Last push
- 2026-08-28T07:51:29Z
- Repository state
- ativo
- Language
- Python
- License
- Apache-2.0
- Added
- 2026-08-29 03:01:18
- Updated
- 2026-08-29 03:01:18
- Origin id
com.opsmill/infrahub-mcp
README
# Infrahub MCP Server Infrahub MCP Server connects AI assistants and IDE agents to [Infrahub](https://github.com/opsmill/infrahub) using the open [Model Context Protocol](https://modelcontextprotocol.io) 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 ```bash pip install infrahub-mcp # or uv pip install infrahub-mcp ``` Docker: ```bash 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): ```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. ## Documentation Full documentation, including client configuration for Cursor, VS Code, Claude Desktop, and Claude Code, is available at the [Infrahub MCP Server docs site](https://docs.infrahub.app/mcp). - [Installation and client setup](https://docs.infrahub.app/mcp/getting-started/installation) - [Docker / sidecar deployment](https://docs.infrahub.app/mcp/guides/docker-compose) - [Authentication modes](https://docs.infrahub.app/mcp/references/authentication) - [Configuration reference](https://docs.infrahub.app/mcp/references/configuration) - [Methods reference — tools, resources, prompts](https://docs.infrahub.app/mcp/references/methods) ## About Infrahub [Infrahub](https://github.com/opsmill/infrahub) is an open source infrastructure data management and automation platform (AGPLv3), developed by [OpsMill](https://opsmill.com). 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](./LICENSE.txt).