UniFi MCP

これは何か： Model Context Protocol (MCP) サーバーのコレクションで、AI アシスタント（Claude、Codex、カスタムエージェントなど）が Ubiquiti UniFi コントローラーと対話できるようにします。Network、Protect（カメラ）、Access（ドア/訪問者）機能を、エージェントが呼び出し可能なツールとして公開します。

主要コンポーネント：

• Network MCP（210 ツール）、Protect MCP（63 ツール）、Access MCP（37 ツール） – それぞれが UniFi アプリを対象とします。
• API サーバー – カスタムアプリと自動化のための独立した HTTP サービス（REST + GraphQL + SSE）。スコープ付き API キーを備えています。
• Cloud Relay – リモートアクセスのベータソリューション：Cloudflare ホストの Worker ゲートウェイがローカルリレーサイドカーとペアリングし、WebSocket 経由で MCP 呼び出しをルーティングします。ローカルサーバーの直接露出を回避します。
• エージェントプラグイン – Claude Code、Codex、OpenClaw 用の公式パッケージで、MCP サーバーをセットアップスキルと安全ガードレールとともにバンドルします。

仕組み：

• サーバーはローカル管理者アカウント（SSO ではない）を使用して UniFi コントローラーに接続します。
• エージェントは標準の MCP ディスカバリを介して、unifi_list_clients、unifi_create_firewall_rule、unifi_get_motion_events などのツールを呼び出します。
• 変更操作はプレビュー→確認フローを使用します。セットアップは資格情報をプライベートファイルに保存し、シークレットの漏洩を防ぎます。
• 遅延読み込みモードは、ドメインツールをオンデマンドで登録するメタツールを公開することで、コンテキストを小さく保ちます。
• 応答サイズは MCP プロトコルバージョンに基づいて適応し、互換性を確保します。

クイックスタート：

• Claude Code の場合：/plugin marketplace add sirkirby/unifi-mcp を実行し、プラグインをインストールします。
• 他のクライアントの場合：uvx unifi-network-mcp@latest などを実行し、環境変数を設定します。

ユースケース：

• 「Guest VLAN 上のすべてのクライアントの信号強度を表示して。」
• 「過去 1 時間に動きを検出したカメラをリストアップして。」
• 「John Smith に明日 9–5 の訪問者パスを作成して。」
• クロスプロダクトインテリジェンス：Network + Protect コンテキストでインシデントを調査します。

このプロジェクトは積極的に開発されており（プラグインはサーバー 0.37.x に固定）、セキュリティモデルを備え、MIT ライセンスで公開されています。AI 駆動のインフラストラクチャ管理のための本格的で重要なツールです。