mcpField
I
infrahub-mcp

infrahub-mcp

ローカル
github.com/opsmillクラウド・インフラ101 日前に更新
リポジトリ

infrahub-mcp について

infrahub-mcp は AI アシスタントや IDE エージェントを Infrahub のインフラデータに接続します。クエリや変更を行え、マージ前に人が承認する仕組みです。

主な機能

  1. 01インフラデータの検索と絞り込み
  2. 02スキーマと GraphQL SDL リソースの確認
  3. 03分離ブランチへの変更書き込み
  4. 04変更提案の承認申請
  5. 05GraphQL クエリとミューテーションの実行

活用シーン

  1. 01自然言語でデバイスや IP アドレスを検索
  2. 02会話中に Infrahub のスキーマを確認
  3. 03人のレビュー用にインフラ更新を準備

MCP 対応

MCP サーバーは Infrahub のデータやスキーマリソースに加え、検索、書き込み、変更提案、GraphQL 操作用のツールを公開します。stdio と Streamable HTTP に対応します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "com-opsmill-infrahub": {
      "command": "uvx",
      "args": [
        "infrahub-mcp"
      ],
      "env": {
        "INFRAHUB_ADDRESS": "<INFRAHUB_ADDRESS>",
        "INFRAHUB_API_TOKEN": "<INFRAHUB_API_TOKEN>"
      }
    }
  }
}
起動コマンドuvx infrahub-mcp
設定が必要な環境変数
INFRAHUB_ADDRESSThe URL/address of your Infrahub instance
INFRAHUB_API_TOKENシークレットYour Infrahub API token for authentication

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypiinfrahub-mcp0.1.2

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Infrahub MCP Server

Infrahub MCP Server は、オープンな Model Context Protocol 標準を使用して、AI アシスタントや IDE エージェントを Infrahub に接続します。これにより、エージェントは一貫性のある監査可能なインターフェースを通じて、インフラストラクチャデータの検索、作成、更新、変更の提案を行えます。カスタムの接続コードは不要で、あらゆる MCP 互換クライアント（Claude Desktop、VS Code、Cursor、CLI エージェントなど）で利用できます。

書き込みはすべてブランチごとに分離され、マージ前に人間の承認が必要です。エージェントがデフォルトブランチを直接変更することはありません。

インストール

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

クイックスタート

環境変数を使ってサーバーを Infrahub インスタンスに接続し、クライアントが必要とするトランスポートで実行します。

stdio（デフォルト — Claude Desktop、VS Code、Cursor 向け）：

export INFRAHUB_ADDRESS=http://localhost:8000
export INFRAHUB_API_TOKEN=<your-token>
infrahub-mcp

Streamable HTTP（リモートクライアント、サイドカーとしてのデプロイ向け）：

infrahub-mcp --transport streamable-http --host 0.0.0.0 --port 8001

できること

  • 自然言語でインフラストラクチャデータを検索 — 属性によるフィルタリングや部分一致検索を使って、デバイス、インターフェース、IP アドレス、またはスキーマ内のあらゆる種類のデータを検索できます。
  • 会話から離れずにスキーマを調査 — サーバーは、カタログ、種類ごとの属性／フィルターマップ、GraphQL SDL を MCP リソースとして公開します。
  • 分離されたブランチで変更 — 書き込みは自動作成されたセッションブランチ（mcp/session-YYYYMMDD-<hex>）に反映されます。デフォルトブランチが直接変更されることはありません。
  • 人間によるレビューに変更を提出 — propose_changes を呼び出すと、マージ前の承認に向けて Proposed Change を作成できます。
  • 任意の GraphQL を実行 — 完全な制御が必要な場合は、Infrahub API に対して任意のクエリやミューテーションを実行できます。

ドキュメント

Cursor、VS Code、Claude Desktop、Claude Code のクライアント設定を含む完全なドキュメントは、Infrahub MCP Server のドキュメントサイトで確認できます。

Infrahub について

Infrahub は、OpsMill が開発する、オープンソースのインフラストラクチャデータ管理・自動化プラットフォーム（AGPLv3）です。インフラストラクチャやネットワークのチームに、デバイス、トポロジ、IP アドレス空間、設定を統合したスキーマ主導の信頼できる情報源を提供します。バージョン管理、オートメーション向けジェネレーターフレームワーク、Git、Ansible、Terraform、CI/CD パイプラインとのネイティブ統合を備えています。

ライセンス

Apache 2.0 — LICENSE を参照してください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。