{
  "markdown": "# Infrahub MCP Server\n\nInfrahub 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.\n\nAll writes are branch-isolated and require human approval before merging — agents never modify your default branch directly.\n\n## Installation\n\n```bash\npip install infrahub-mcp\n# or\nuv pip install infrahub-mcp\n```\n\nDocker:\n\n```bash\ndocker pull registry.opsmill.io/opsmill/infrahub-mcp:latest\n# or use Docker Compose:\ndocker compose up -d\n```\n\n## Quickstart\n\nPoint the server at your Infrahub instance via environment variables, then run it over the transport your client expects.\n\n**stdio** (default — for Claude Desktop, VS Code, Cursor):\n\n```bash\nexport INFRAHUB_ADDRESS=http://localhost:8000\nexport INFRAHUB_API_TOKEN=<your-token>\ninfrahub-mcp\n```\n\n**Streamable HTTP** (for remote clients, sidecar deployments):\n\n```bash\ninfrahub-mcp --transport streamable-http --host 0.0.0.0 --port 8001\n```\n\n## What you can do with it\n\n- **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.\n- **Explore your schema without leaving the conversation** — the server exposes your catalog, per-kind attribute/filter maps, and the GraphQL SDL as MCP resources.\n- **Make changes on isolated branches** — writes land on an auto-created session branch (`mcp/session-YYYYMMDD-<hex>`); the default branch is never touched directly.\n- **Submit changes for human review** — call `propose_changes` to open a Proposed Change for approval before merging.\n- **Run arbitrary GraphQL** — execute any query or mutation against the Infrahub API when you need full control.\n\n## Documentation\n\nFull 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).\n\n- [Installation and client setup](https://docs.infrahub.app/mcp/getting-started/installation)\n- [Docker / sidecar deployment](https://docs.infrahub.app/mcp/guides/docker-compose)\n- [Authentication modes](https://docs.infrahub.app/mcp/references/authentication)\n- [Configuration reference](https://docs.infrahub.app/mcp/references/configuration)\n- [Methods reference — tools, resources, prompts](https://docs.infrahub.app/mcp/references/methods)\n\n## About Infrahub\n\n[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.\n\n## License\n\nApache 2.0 — see [LICENSE](./LICENSE.txt).\n",
  "bytes": 3219,
  "sha": "475ddd0e9e2c6a21d8af9fe3098ece973ed6db379b389946828c112346d91bf2",
  "repo_slug": "opsmill/infrahub-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_opsmill_infrahub_mcp_bd5e9c6d/readme"
}