Minibridge

Minibridge

Minibridge はバックエンドとフロントエンドをつなぐブリッジとして機能し、 エージェントと MCP サーバー間の通信を簡素化し、安全にします。MCP サーバーをインターネットに安全に公開し、必要に応じて Policers と呼ばれる汎用のポリシー適用サービスと連携して、エージェントの認証、コンテンツ分析、変換を行えます。Policer は HTTP 経由でリモートに、または OPA Regoポリシーを使ってローカルに実装できます。

Minibridge は、SBOM（ソフトウェア部品表）の生成とリアルタイム検証を通じて、 MCP サーバーの整合性を確保するのに役立ちます。

さらに、Minibridge は OTEL をサポートしており、従来の OTEL ヘッダーからトレース／スパンを報告・再接続できるほか、 Open Inferenceなどの特定のツールによって挿入された MCP 呼び出しから直接報告・再接続することもできます。

• Minibridge Frontend：クライアントは Minibridge のフロントエンド部分に接続します。
• Minibridge Backend：フロントエンドは、MCP サーバーをラップするバックエンドに接続します。
• Minibridge Policer：Policer はバックエンドで実行され、必要に応じてポリシーに基づいて入力と出力を判断できます（ローカルでは Rego を使用し、リモートでは HTTPS を使用します）。

ヒント

Minibridge は、単一プロセスとして動作する「オールインワン」（AIO）モードで簡単に起動できます。

Minibridge を使う理由

Minibridge は以下の機能を提供します。

• セキュアなトランスポート：必要に応じてクライアント証明書の検証を行い、TLS を使用します。
• 整合性：実行中に MCP サーバーのツール、テンプレートなどが変更されないようにします。
• ユーザー認証：ユーザー情報を Policer に渡します。
• モニタリング：Prometheus メトリクスを公開します。
• テレメトリー：OpenTelemetry を使ってトレースとスパンを報告します。

インストール

Minibridge はさまざまな方法でインストールできます。

Homebrew

macOS では、Homebrew を使用できます。

brew tap acuvity/tap
brew install minibridge

AUR

Arch ベースの Linux ディストリビューションでは、次のコマンドを実行できます。

yay -S minibridge

または、main ブランチから最新バージョンを取得するには、次のコマンドを実行します。

yay -S minibridge-git

Go

Go ツールチェーンがインストールされている場合：

go install go.acuvity.ai/minibridge@latest

または、main ブランチから最新バージョンを取得するには、次のコマンドを実行します。

go install go.acuvity.ai/minibridge@main

手動

リリース ページから、お使いのプラットフォーム向けのバイナリを簡単にダウンロードできます。

機能比較

🚀 機能	🔹 MCP	🔸 Minibridge	📦 ARC (Acuvity Containers)
🌐 リモートアクセス	⚠️	✅	✅
🔒 TLS サポート	❌	✅	✅
📃 ツールの整合性チェック	❌	✅	✅
📊 可視化とトレース	❌	✅	✅
🛡️ 分離	❌	⚠️	✅
🔐 セキュリティポリシー管理	❌	👤	⚠️
🕵️ シークレットのマスキング	❌	👤	⚠️
🔑 認可制御	❌	👤	👤
🧑‍💻 個人識別情報（PII）の検出とマスキング	❌	👤	👤
📌 バージョンの固定	❌	❌	✅

✅ 含まれています | ⚠️ 一部／基本的なサポート | 👤 ユーザーによるカスタム実装 | ❌ サポートされていません

例：MCP クライアントでの Minibridge の設定

クライアントの設定で、MCP サーバーが最初に次のように指定されているとします。

{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

リクエストを Minibridge 経由でルーティングするには（SBOM チェックやポリシーの適用などを有効にするため）、エントリを次のように更新します。

{
  "mcpServers": {
    "fetch": {
      "command": "minibridge",
      "args": ["aio", "--", "uvx", "mcp-server-fetch"]
    }
  }
}

• minibridge aio：Minibridge を「all-in-one」モードで起動し、下流のツールをラップします。
• uvx mcp-server-fetch：元の MCP サーバーコマンドです。Minibridge 内で実行されるようになりました。

ヒント

設定ファイルの場所は、使用するクライアントによって異なります。たとえば、Claude Desktop を使用する場合、設定ファイルは次の場所にあります。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

公式ドキュメントのMCP QuickStart for Claude Desktop Usersを参照してください。

重要

クライアントがバイナリのパスを解決できる必要があります。 MCP fetch: spawn minibridge ENOENTのようなエラーが表示される場合は、上記のcommandパラメーターにminibridgeのフルパスを設定してください（which minibridgeでフルパスを確認できます）。

ドキュメント

Wiki ページにあるドキュメント一式をご覧ください。

貢献

皆さまからの貢献を心よりお待ちしています！🎉 バグの修正、機能の強化、ドキュメントの改善、新しいアイデアの提案など、皆さまの参加によってプロジェクトが強化され、コミュニティ全体に役立ちます。

Contributor License Agreement（CLA）への署名は不要です。プルリクエストを作成して、ぜひ一緒に取り組みましょう！

参加する

• Discord
• LinkedIn
• Bluesky
• Docker