📡 UniFi Network MCP Server

UniFi MCP

エージェントとエージェント型 AI ワークフローを活用して、UniFi のデプロイを管理できます。

サーバー

サーバー	ステータス	ツール	パッケージ
Network	安定版	210	unifi-network-mcp
Protect	安定版	63	unifi-protect-mcp
Access	安定版	37	unifi-access-mcp

プラグイン

Claude Code、Codex、または OpenClaw のマーケットプレイスからインストールしてください。手順はクイックスタートをご覧ください。

プラグイン	提供内容
unifi-network	Network MCP サーバー、そのエージェントスキル、ガイド付きセットアップ
unifi-protect	Protect MCP サーバー、そのエージェントスキル、ガイド付きセットアップ
unifi-access	Access MCP サーバー、そのエージェントスキル、ガイド付きセットアップ
unifi-intelligence	Network と Protect を組み合わせ、すべての主張に出典を付けて横断的に調査します。Incident Investigation はローカルで実行されます。Security Patrol と Visitor Audit にはクラウドワーカーが必要です。Network プラグインと Protect プラグインが必要です

エージェントスキルの表では、各プラグインに含まれるすべてのスキルを確認できます。

統合方法を選択する

構築するもの	使用するもの	理由
AI アシスタント、または既存の別の MCP クライアント	Network、Protect、または Access MCP サーバー	標準的な MCP の検出、ツール呼び出し、権限、確認フロー
カスタムアプリケーション、自動化サービス、コード実行ランタイム、または MCP アダプター	unifi-api-server	呼び出しの順序付け、データの結合、リソース制限、承認フローをコードで制御できます
MCP クライアントからのリモートアクセス	Cloud Relay	ローカルサーバーを直接公開せずに、認証済みのリモート MCP ルーティングを利用できます

MCP アダプターでは、バックエンドとして unifi-api-server を使用しながら、 少数のツールを公開できます。これにより、アプリケーション固有の結合、分岐、ループ、 コードの分離を汎用 MCP サーバーから切り離せます。

Cloud Relay

コンポーネント	ステータス	パッケージ
Relay Sidecar	ベータ	unifi-mcp-relay
Worker Gateway	ベータ	unifi-mcp-worker（CLI）

Cloud Relay は、Cloudflare でホストされる Worker ゲートウェイと、LAN 上の Relay サイドカーを連携させます。Worker は、認証済みのエッジ MCP エンドポイント、Durable Object ブローカー、複数ロケーションへのルーティング、トークン境界、デプロイ／管理用 CLI を提供します。Relay サイドカーはローカルの MCP HTTP クライアント兼フォワーダーです。設定済みのローカル MCP サーバーを HTTP 経由で検出し、Worker への送信 WebSocket 接続を維持します。リモートリクエストは MCP client → Worker gateway → outbound WebSocket → Relay sidecar → local MCP servers over HTTP の経路をたどります。この経路に API サーバーは含まれません。読み取り専用ツールはアノテーションに基づく複数ロケーションへのファンアウトに対応し、書き込みには明示的なロケーション指定が必要です。npm install -g unifi-mcp-worker && unifi-mcp-worker install で Worker をデプロイし、ローカルサーバーの接続方法についてはRelay サイドカーの READMEを参照してください。

REST + GraphQL API

コンポーネント	ステータス	パッケージ
API Server	ベータ	unifi-api-server · GHCR イメージ

unifi-api-server は、カスタムアプリケーション、 自動化、アダプター向けの独立した HTTP サービスです。型付き REST リソース、読み取り専用の GraphQL クエリ、SSE ストリーム、スコープ付き API キーと管理機能に加え、サポート対象のコントローラー操作向け REST アクション エンドポイントを提供します。MCP サーバーと unifi-core マネージャーを共有しますが、それらをプロキシしたり、必要としたりすることはありません。

クイックスタートとデプロイのパターンについては、apps/api/README.mdを参照してください。

これは何ですか？

UniFi MCP は、AI アシスタントや自動化ツールから Ubiquiti UniFi コントローラーを操作できる、Model Context Protocol サーバーのコレクションです。各サーバーは特定の UniFi アプリケーション（Network、Protect、Access）を対象とし、その機能を MCP ツールとして公開します。これらのツールは、既定でクエリ可能、組み合わせ可能、かつ安全です。

MCP HTTP アクセス

MCP HTTP は認証されておらず、信頼できるローカルクライアント向けです。HTTP は既定で無効になっており、有効にした場合、パッケージはループバックにバインドします。Docker Compose ではコンテナーネットワーク上で有効になり、ホストの 127.0.0.1 でポート 3000–3002 を公開します。リモートアクセスには認証済み TLS プロキシまたは Cloud Relay を使用し、バックエンドへの直接アクセスを防いでください。トランスポートのセキュリティモデルとHTTP のセットアップと移行を参照してください。

設定	既定値	目的
UNIFI_MCP_HTTP_ENABLED	false	HTTP トランスポートを有効にします
UNIFI_MCP_HOST	127.0.0.1	バインドアドレス。Compose はコンテナー内で明示的に 0.0.0.0 を使用します
UNIFI_MCP_HTTP_FORCE	false	コンテナーの PID 1 以外で HTTP を許可します
UNIFI_MCP_ALLOWED_HOSTS	localhost,127.0.0.1	受け入れる Host ヘッダーの一覧全体。Compose は必要な内部ホストを別途追加します
UNIFI_MCP_ENABLE_DNS_REBINDING_PROTECTION	true	DNS リバインディングリクエストを防ぐため、Host ヘッダーを検証します

MCP の検出

UniFi MCP では、標準の MCP パスを優先します。対応クライアントは tools/list で現在登録されているツールを検出し、tools/call で呼び出します。デフォルトの lazy モードでは、まずメタツールを公開して初期コンテキストを小さく保ちます。一方、eager モードでは、標準のツールリスト全体を必要とするクライアント向けに、選択したドメインのツールをすべて直接登録します。

遅延読み込みのメタツール — *_tool_index、*_execute、*_batch、*_batch_status、および遅延読み込み専用の *_load_tools — は、フィルターを使った検出、間接的な実行、バッチ処理の調整、任意の直接登録に対応します。これらは、以下で説明するプロトコルバージョンの応答互換性ポリシーとは独立しています。モードごとの動作については、MCP の検出と遅延読み込みメタツールを参照してください。

MCP の応答サイズ

構造化出力をすでに返すツール結果では、デフォルトの応答モードは adaptive です。このモードでは、クライアントの製品名やアプリケーションのバージョンではなく、MCP の初期化時に通知される正規の日付ベースの protocolVersion に基づいて各リクエストを分類します。MCP 2025-06-18 以降を通知するリクエストでは、content に簡潔なテキストを、structuredContent に完全な結果を一度だけ返します。それ以前のリビジョン（2024-11-05 や 2025-03-26 など）を通知するリクエスト、またはリビジョンのメタデータが欠落しているか不正な形式のリクエストでは、完全な互換性 JSON を content に返します。重複した互換形式を強制するには UNIFI_MCP_CONTENT_MODE=compat を設定してください。ネゴシエーションされたリクエスト以外でも、簡潔なテキストと完全な構造化結果を強制するには UNIFI_MCP_CONTENT_MODE=compact を設定してください。通知されたリビジョンにかかわらず、完全な結果を content からのみ取得するクライアントには compat を使用してください。

遅延読み込みのメタツールは引き続き content のみを使用します。これらは、上記で説明した 2025-06-18 より前のプロトコル分類には該当しません。構造化された内部結果の場合、*_execute と *_batch_status は、入れ子になったトランスポートのペアではなく、正規化された JSON ペイロードを 1 つ content に公開します。content のみを使用する実行結果は変更されません。応答モードによって、これらのメタツールが structuredContent に変わることはありません。

UNIFI_NETWORK_MCP_CONTENT_MODE、UNIFI_PROTECT_MCP_CONTENT_MODE、UNIFI_ACCESS_MCP_CONTENT_MODE は、それぞれのサーバーに対してグローバル設定を上書きします。トランスポートの圧縮とは別に、Network の unifi_get_dashboard はデフォルトで summary=true を使用し、unifi_list_rogue_aps はデフォルトで最大 100 件の要約ページを使用します。選択したデータ全体が必要な場合は、summary=false を渡してください。

クイックスタート

エージェントを使ってインストールする

以下のブロックをコーディングエージェントに貼り付けてください。エージェントに正規のバージョン管理されたセットアップガイドを参照させ、変更できる範囲を制限します。

Install UniFi MCP for me using the official instructions at:
https://github.com/sirkirby/unifi-mcp/blob/main/docs/agent-install.md

Before changing anything, identify my agent client and operating system, ask
whether I need Network, Protect, Access, or more than one, and show me the exact
commands and configuration files you plan to change. Wait for my confirmation.
Do not ask me to paste a password or API key into chat. Prefer an indirect
credential provider or the client's secure secret prompt. Keep mutation
permissions in confirm mode and explicitly deny create, update, and delete
unless I opt in. After setup, reload the client, verify the MCP connection and
tool list, and run one harmless read-only check.

このガイドでは、ネイティブプラグイン、製品別の npx skills add インストール、OpenCode に組み込まれた MCP サポートのほか、Antigravity、Cursor、Devin Desktop の現在の手動設定方法を説明しています。スキルをインストールするとエージェント向けのガイダンスが追加されますが、それだけで MCP サーバーが登録されるわけではありません。

各プラグインリリースでの変更内容については変更履歴を、既存のインストールを更新する前にプラグインのアップグレードガイドを参照してください。

Claude Code（推奨）

プラグインマーケットプレイスからインストールします。MCP サーバー、エージェントスキル、ガイド付きセットアップが含まれています。

/plugin marketplace add sirkirby/unifi-mcp
/plugin install unifi-network@unifi-plugins
/unifi-network:unifi-network-setup

必要に応じて、Protect または Access についても同じ手順を繰り返します。

/plugin install unifi-protect@unifi-plugins
/plugin install unifi-access@unifi-plugins

複数の製品にまたがるスキルでは、/plugin install unifi-intelligence@unifi-plugins を実行すると、必要な Network プラグインと Protect プラグインもインストールされます。Claude Code は依存関係としてインストールするプラグインのオプションダイアログを開かないため、まだ設定していない製品については、それぞれのセットアップコマンド（/unifi-network:unifi-network-setup、/unifi-protect:unifi-protect-setup）を実行してください。

製品プラグインの/plugin installを実行すると、オプションダイアログがすぐに開きます。そこで入力するか、ダイアログを閉じてセットアップコマンドを実行してください。各プラグインのセットアップコマンドでは、コントローラーへの接続と権限の設定を順に行い、その結果をプラグインの Claude Code オプションとして保存します。このマーケットプレイスでは、デフォルトで自動更新がオフになっています。更新手順については、プラグインのアップグレードガイドをご覧ください。

各クライアントの前提条件、バージョンの制限、検証状況については、プラグイン対応マトリックスをご覧ください。

Codex

UniFi MCP マーケットプレイスを登録し、Codex の/plugins UI からプラグインをインストールします。

codex plugin marketplace add sirkirby/unifi-mcp

codexを起動し、/pluginsを実行して UniFi MCP マーケットプレイスを開き、unifi-network、unifi-protect、またはunifi-accessをインストールします。unifi-intelligenceは複数の製品にまたがるスキルを追加します。Codex はプラグインの依存関係をインストールしないため、その前にunifi-networkとunifi-protectをインストールしてセットアップしてください。インストール後、Codex にプラグインのセットアップスキルを実行するよう依頼します。例：

unifi-network-setupスキルを使って、Codex 用に設定してください。

セットアップスキルは、コントローラーの設定と認証情報プロバイダーへの参照をプライベートファイル~/.config/unifi-mcp/<product>.envに保存します。このファイルはプラグイン専用のサーバーが読み込み、Claude Code と同じ、確認前にプレビューする安全モデルを維持します。Codex はセッションの開始時にプラグインのアップグレードを独自にインストールし、サーバーも含まれるため、再実行は不要です。プラグイン 1.0.0 より前に Codex のセットアップを実行した場合は、一度だけ--refreshを実行してください。詳しくはプラグインのアップグレードガイドをご覧ください。

UniFi アカウントの要件

MCP サーバーは、ローカルの管理者／サービスアカウントを使用して、ローカルの UniFi コントローラー API に認証します。MCP のセットアップに Ubiquiti SSO クラウドアカウントを使用しないでください。現時点では、Network MCP の設定で SSO MFA またはローカル 2FA が必須のアカウントはサポートされていません。サービスアカウントには、MCP サーバーに付与しても問題のない権限に範囲を限定した、MFA を使用しない専用のローカル管理者アカウントを使用してください。

OpenClaw

OpenClaw は、マーケットプレイスから同じ UniFi プラグインバンドルをインストールし、そのスキルと MCP サーバーの定義を組み込み Pi セッションにマッピングできます。

openclaw plugins install unifi-network --marketplace https://github.com/sirkirby/unifi-mcp
openclaw gateway restart

ターミナルでは、OpenClaw がソースとプラグインの機能を確認するよう求めます。スクリプトなど、ターミナルを使わない場合は、--force --accept-capabilities を追加してください。追加しないと拒否されます。

続いて、OpenClaw から対応するセットアップスキル（unifi-network-setup、unifi-protect-setup、または unifi-access-setup）を実行するか、プラグインのセットアップスクリプトを自分で実行します。コマンドラインにシークレットが表示されないよう、パスワードには認証情報プロバイダーを指定してください。

bash ~/.openclaw/extensions/unifi-network/scripts/set-env.sh --target openclaw \
  UNIFI_NETWORK_HOST=192.168.1.1 \
  UNIFI_NETWORK_USERNAME=admin \
  'UNIFI_NETWORK_PASSWORD_FILE=/absolute/path/to/password-file'

セットアップでは、これらの設定が ~/.config/unifi-mcp/network.env に保存されます。このファイルは本人だけが読み取れ、プラグイン独自のサーバーが読み込みます。openclaw.json にはエントリが追加されないため、openclaw plugins update を実行すれば、再設定することなく各サーバーを新しいバージョンに更新できます。openclaw.json に mcp.servers.unifi-network のエントリがある場合は、プラグインのサーバーが置き換えられ、そのバージョンが固定されます。プラグイン 1.0.0 より前のセットアップではこのエントリが書き込まれていましたが、set-env.sh --target openclaw --refresh を一度実行すれば変換できます（アップグレードガイドを参照）。必要に応じて unifi-protect または unifi-access でも同じ手順を繰り返してください。製品を横断するスキルだけを提供する unifi-intelligence は、unifi-network と unifi-protect のセットアップ後にインストールしてください。OpenClaw はプラグインの依存関係をインストールしません。

その他の MCP クライアント

サーバーを直接実行します。

uvx unifi-network-mcp@latest
uvx unifi-protect-mcp@latest
uvx unifi-access-mcp@latest

Claude Desktop の場合は、claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "unifi-network": {
      "command": "uvx",
      "args": ["unifi-network-mcp@latest"],
      "env": {
        // Server-specific vars take priority; UNIFI_* is the fallback
        "UNIFI_NETWORK_HOST": "192.168.1.1",
        "UNIFI_NETWORK_USERNAME": "admin",
        "UNIFI_NETWORK_PASSWORD": "your-password"
      }
    },
    "unifi-protect": {
      "command": "uvx",
      "args": ["unifi-protect-mcp@latest"],
      "env": {
        "UNIFI_PROTECT_HOST": "192.168.1.1",
        "UNIFI_PROTECT_USERNAME": "admin",
        "UNIFI_PROTECT_PASSWORD": "your-password"
      }
    },
    "unifi-access": {
      "command": "uvx",
      "args": ["unifi-access-mcp@latest"],
      "env": {
        "UNIFI_ACCESS_HOST": "192.168.1.1",
        "UNIFI_ACCESS_USERNAME": "admin",
        "UNIFI_ACCESS_PASSWORD": "your-password"
      }
    }
  }
}

ヒント： すべてのサーバーが同じコントローラーに接続する場合、サーバーごとに設定を繰り返す代わりに、共通の UNIFI_HOST／UNIFI_USERNAME／UNIFI_PASSWORD 変数を使用できます。

使用例

接続したら、AI エージェントに自然な言葉で尋ねるだけです。

Network

「Guest VLAN 上のすべてのクライアントについて、信号強度とデータ使用量を表示して」 「IoT デバイスが深夜から午前 6 時までインターネットに接続できないようにするファイアウォールルールを作成して」 「ファイアウォールポリシーを監査して。重複または競合するルールはある？」 「直近 1 時間のトラフィックフローを上位から表示し、宛先ごとにまとめて」

Protect

「直近 1 時間に動きを検知したカメラをすべて一覧表示して」 「今日、玄関のカメラで検知されたスマート検知イベントを表示して。人と車両だけで」 「今週、白いバンが車道で検知された記録を探して」

Access

「今日、誰が社員証でオフィスに入った？すべてのドアのアクセスイベントを時系列で表示して」 「明日の午前 9 時から午後 5 時まで正面入口にアクセスできるよう、John Smith の来訪者パスを作成して」

UniFi Intelligence（unifi-intelligence プラグイン）

「aa:bb:cc:00:10:02 のスイッチが今朝、ニューヨーク時間の午前 8 時 45 分に接続を失った。午前 8 時から 9 時の間に何があった？」— Network のイベントと、カバー範囲を含む対応する Protect カメラのイベントを引用します 「直近 1 時間に正面入口で起きたことをすべて表示して」— クラウドワーカーとリレーが必要です

変更を適用する前に、すべての変更内容を確認できるプレビューしてから確定するフローを、すべての変更操作で使用します。

設定

これらの変数をサーバーのプロセス環境（シェルのエクスポート、MCP クライアントの env ブロック、または Docker の environment: / env_file:）に設定します。

変数	必須	説明
UNIFI_HOST	はい	コントローラーの IP アドレスまたはホスト名
UNIFI_USERNAME	はい	ローカル管理者／サービスアカウントのユーザー名。Ubiquiti SSO アカウントは使用しないでください
UNIFI_PASSWORD	はい	ローカルアカウントのパスワード
UNIFI_API_KEY	いいえ	ファイアウォールポリシーの順序変更や一部の Protect 設定の更新など、選択した機能に使用する UniFi API キー
CONFIG_PATH	いいえ	オペレーターが管理するカスタム YAML ファイルの絶対パス。指定しない場合は、同梱の設定を使用します
UNIFI_SETTINGS_FILE	いいえ	ユーザーごとの UNIFI_* 変数を記述した設定ファイルの絶対パス（~ を使用できます）。詳細は以下を参照してください
UNIFI_DEFER_CONTROLLER_INIT	いいえ	Network のみ：起動時にコントローラーへ接続せず、最初のツール呼び出し時に接続します。デフォルトでは、各サーバーはすぐに MCP クライアントへ応答し、バックグラウンドで接続します
UNIFI_META_TOOLS_ENABLED	いいえ	Network の即時起動モードのみ：間接的なメタツールを省略するには false を設定します。UNIFI_ENABLED_CATEGORIES または UNIFI_ENABLED_TOOLS が必要です

起動時の設定： サーバーは、作業ディレクトリにある .env ファイルや config/config.yaml を自動的に読み込みません。MCP クライアントは信頼できないプロジェクト内でサーバーを起動する場合があるため、プロジェクト内のファイルによって認証情報の送信先が制御されたり、権限やマスキングが弱められたりしないようにする必要があります。以前、自動読み込みに依存していた場合は、ランチャーで信頼できる env ファイルを指定する（例：uv run --env-file /absolute/path/to/trusted.env --with unifi-network-mcp unifi-network-mcp）か、カスタム YAML 用に絶対パスの CONFIG_PATH を設定してください。Docker Compose の env_file: は引き続き使用できます。

ユーザーごとの設定ファイル： UNIFI_SETTINGS_FILE は、サーバーが起動時に、ほかのものが設定を読み込む前に読み取るファイルを指定します。Codex プラグインのセットアップでは ~/.config/unifi-mcp/<product>.env が作成され、同梱のサーバーにそのファイルが指定されます。このファイルには KEY=VALUE の行を記述します（# コメント、対応する引用符は任意。export、値の展開、複数行の値には対応していません）。受け付けるのは UNIFI_* キーのみで、それぞれは _FILE / _COMMAND プロバイダーやポリシーゲートを含め、エクスポートされた場合とまったく同じように動作します。プロセス環境にすでに設定されている変数が優先されます。ファイルが存在しなくてもエラーにはなりません。POSIX ではファイルの所有者が自分であり、グループやほかのユーザーが書き込めないようにする必要があります（chmod 600 を維持してください）。Windows ではモードのチェックがないため、ユーザープロファイル内に保管してください。

シークレットを MCP クライアントの環境（およびクライアントが起動するすべてのプロセス）に含めないようにするには、内容がパスワードのファイルを指す UNIFI_PASSWORD_FILE を設定するか、標準出力がパスワードとなる絶対パスの argv を指定した UNIFI_PASSWORD_COMMAND を設定します（仕様）。同じ _FILE / _COMMAND 接尾辞は、UNIFI_API_KEY およびサーバーごとの以下の変数にも使用できます。詳細は各サーバーの docs/configuration.md を参照してください。

複数コントローラーのセットアップ

各サーバーでは、それぞれのプレフィックス付き環境変数が共有の UNIFI_* 変数より優先されます。これにより、ランチャーで明示的に読み込む信頼済みの環境ファイルを1つに保ちながら、Network サーバーと Protect サーバーを別々のコントローラー（または別々の認証情報）に接続できます。

共有（フォールバック）	Network サーバー	Protect サーバー	Access サーバー
UNIFI_HOST	UNIFI_NETWORK_HOST	UNIFI_PROTECT_HOST	UNIFI_ACCESS_HOST
UNIFI_USERNAME	UNIFI_NETWORK_USERNAME	UNIFI_PROTECT_USERNAME	UNIFI_ACCESS_USERNAME
UNIFI_PASSWORD	UNIFI_NETWORK_PASSWORD	UNIFI_PROTECT_PASSWORD	UNIFI_ACCESS_PASSWORD
UNIFI_PORT	UNIFI_NETWORK_PORT	UNIFI_PROTECT_PORT	UNIFI_ACCESS_PORT
UNIFI_VERIFY_SSL	UNIFI_NETWORK_VERIFY_SSL	UNIFI_PROTECT_VERIFY_SSL	UNIFI_ACCESS_VERIFY_SSL
UNIFI_API_KEY	UNIFI_NETWORK_API_KEY	UNIFI_PROTECT_API_KEY	UNIFI_ACCESS_API_KEY

コントローラーが1つの場合は、共有の UNIFI_* 変数を設定するだけで、すべてのサーバーでその値が使用されます。サーバー固有の変数が必要なのは、サーバーごとに異なるコントローラーへ接続する場合や、異なる認証情報を使用する場合だけです。

権限、トランスポート、高度なオプションを含む設定の完全なリファレンスについては、Network サーバーのドキュメント、Protect サーバーのドキュメント、またはAccess サーバーのドキュメントをご覧ください。

シークレットの秘匿化

ツールおよび API の応答では、既知のコントローラーのシークレットフィールドがデフォルトで秘匿化されます。対象は、Wi-Fi のパスフレーズ、VPN の秘密鍵／事前共有鍵、VPN 設定全体（インポートされた WireGuard／OpenVPN の .conf／.ovpn ファイル）、API トークン、SNMP コミュニティ文字列、SNMPv3 パスワード、デバイスの SSH 認証情報と管理キー、Access の認証情報トークン／PIN 値です。これらは ***REDACTED*** として返されます。これにより、シークレットがエージェントのコンテキストやログに含まれないようにできます。

信頼済みのローカル管理ワークフローで実際の値が必要な場合は、UNIFI_REDACT_SENSITIVE_FIELDS=false を設定するか、UNIFI_NETWORK_REDACT_SENSITIVE_FIELDS=false、UNIFI_PROTECT_REDACT_SENSITIVE_FIELDS=false、UNIFI_ACCESS_REDACT_SENSITIVE_FIELDS=false、UNIFI_API_REDACT_SENSITIVE_FIELDS=false などのサーバー固有の設定で、そのプロセスの秘匿化を無効にしてください。更新時に既存のシークレットを維持するには、該当フィールドを省略してください。***REDACTED*** マーカーを返してはいけません。プレースホルダーが実際のシークレットとして書き込まれないよう、その値は拒否されます。秘匿化されるフィールドの完全な一覧は、PRIVACY.mdをご覧ください。

エージェントスキル

各プラグインには、単なるツールアクセスにとどまらないエージェントスキルが含まれています。エージェントが一般的なタスクを効果的に実行する方法を学べます。

スキル	プラグイン	機能
ネットワークヘルスチェック	unifi-network	結果の解釈に役立つリファレンスドキュメントを使い、デバイス、ヘルスサブシステム、アラームを一括で診断します
ファイアウォール管理	unifi-network	ポリシーテンプレート、設定スナップショット、変更追跡を備えた自然言語によるファイアウォール管理です
ファイアウォール監査	unifi-network	16 項目のベンチマーク、100 点満点のスコアリング、トポロジー分析、傾向追跡によるセキュリティ監査です
セキュリティダイジェスト	unifi-protect	対象範囲の明示的な制限を含む Protect イベントの概要です。Access と Network の読み取りを追加すると、相関関係の仮説も提示できます
UniFi Access	unifi-access	ドア制御、認証情報、訪問者、アクセス ポリシーを管理し、リアルタイムのイベントストリーミングとアクティビティ概要を提供します
インシデント調査	unifi-intelligence	読み取り専用のインシデント証拠ツールを使い、Protect カメラのコンテキストと引用付きの対象範囲を含めて、1 件の Network デバイスインシデントを調査します
セキュリティパトロール	unifi-intelligence	クラウドワーカーが統合した位置情報タイムラインから、エリアのアクティビティを確認します
訪問者監査	unifi-intelligence	クラウドワーカーのタイムライン上で、Access イベントと Network の証拠を照合し、ID に関する制限も示します

スキルには、デバイスの状態、アラームの種類、ファイアウォールのスキーマ、イベントフィールドに関するリファレンスドキュメントが含まれています。エージェントは証拠を収集して解釈します。ファイアウォールのスコア CLI は、対応する検出結果からスコアを計算します。ファイアウォールのスナップショット、差分、テンプレートの適用は、スキルの指示に従って行います。

セットアップ以外の各スキルでは、必須および任意のサーバーが宣言され、レポートに「対象範囲と制限」セクションを含めることが求められます。必須の依存関係が不足している場合、ワークフローは停止します。任意のソースの不足、読み取りの失敗、結果の上限は明示されます。セキュリティパトロールと訪問者監査には、接続されたリレーを通じてクラウドワーカーが統合したタイムラインが必要です。詳しくは、製品間の機能をご覧ください。

アーキテクチャ

このプロジェクトは、共有パッケージを使用するモノレポです。

apps/
  network/          # UniFi Network MCP server (stable, 210 tools)
  protect/          # UniFi Protect MCP server (stable, 63 tools)
  access/           # UniFi Access MCP server (stable, 37 tools)
  api/              # Independent REST + GraphQL API server (beta)
  worker/           # Cloudflare Worker gateway + npm CLI
packages/
  unifi-core/       # Shared UniFi connectivity (auth, detection, retry)
  unifi-mcp-shared/ # Shared MCP patterns (permissions, tools, diagnostics, config)
  unifi-mcp-relay/  # Cloud relay sidecar (bridges local servers to Cloudflare Worker)
plugins/
  unifi-network/    # Claude Code/Codex/OpenClaw plugin: MCP server + agent skills + setup
  unifi-protect/    # Claude Code/Codex/OpenClaw plugin: MCP server + agent skills + setup
  unifi-access/     # Claude Code/Codex/OpenClaw plugin: MCP server + agent skills + setup
  unifi-intelligence/ # Skills-only plugin; needs unifi-network and unifi-protect
skills/
  _shared/          # Shared utilities for skill scripts (MCP client, config)
docs/               # Ecosystem-level documentation

apps/ 内の各 Python サーバーは、共有パッケージに依存する独立したパッケージです。apps/worker/ は意図的に分離されています。Cloudflare Worker ゲートウェイと npm CLI 用の、自己完結型の TypeScript/Node アプリです。これをこのリポジトリに含めることで、リレープロトコルの変更とワーカーの契約テストを一緒に進められます。

詳しくは、docs/ARCHITECTURE.mdをご覧ください。

開発

make sync   # Install Python workspace + worker npm dependencies
make check  # Format check + lint + generated drift checks + tests + worker typecheck
make build  # Build deployable artifacts, including worker typecheck

コントリビュート

モノレポでの作業方法、テストの実行方法、PR の提出方法など、開発ワークフローについてはCONTRIBUTING.mdをご覧ください。

プロジェクトを支援する

UniFi MCP は、独立したオープンソースプロジェクトとして保守されています。スポンサーからの支援は、プロジェクトの構築、テスト、保守にかかる継続的な AI コストに加え、実機コントローラーとの互換性テスト、リリースの保守、ドキュメント作成、Network、Protect、Access、API、リレー、プラグインの各パッケージに関する課題のトリアージを支えます。

再現可能な Network、Protect、Access MCP の問題について、サーバーを起動してツールを登録できる場合は、公開のバグ報告を作成する前に、任意のサニタイズ済みサポートバンドルを生成して内容を確認してください。起動できない場合は、バグ報告の手動入力欄を使用してください。サポートバンドルは通常の診断ログより安全ですが、サニタイズ済みであり、匿名化されているわけではありません。

• GitHub でスポンサーになる
• スポンサー資金の使途を見る

ライセンス

MIT