sirkirby/unifi-mcp

何を解決するか

UniFi MCP は AI アシスタントや自動化ツールが Ubiquiti UniFi コントローラーとやり取りできるようにします。自然言語インターフェースと複雑なネットワークインフラ管理の間のギャップを埋め、AI エージェントを使って UniFi Network、Protect、Access のデプロイメントを照会、監査、変更できるようにします。

動作方法

このプロジェクトは Model Context Protocol (MCP) を実装し、UniFi コントローラーの機能を照査可能で組み合わせ可能なツールのセットとして公開します。ネットワーク、Protect、Access の各専用サーバーで構成されており、管理アカウントを使ってローカルコントローラーに接続します。

リモートアクセスには「Cloud Relay」システムを使用します：Cloudflare がホストする Worker ゲートウェイが認証済みエッジエンドポイントとして機能し、WebSocket を介してローカルの Relay サイドカーと通信し、リクエストをローカル MCP サーバーに転送します。また、MCP 以外のコンシューマー向けに独立した REST および GraphQL API サーバーも含まれています。

対象ユーザー

UniFi ハードウェアを使用し、手動のダッシュボードナビゲーションではなく AI ベースのエージェント（Claude Code、Codex、OpenClaw など）を使ってインフラを管理したいネットワーク管理者やホームラボ愛好家向けに設計されています。

特徴

• 包括的なツールセット：ネットワーク（192）、Protect（61）、Access（36）の各ドメインで合計数百のツールを提供。
• エージェントスキル：ネットワークの健全性チェック、100点満点評価によるファイアウォール監査、セキュリティ要約などの複雑なタスク用に事前に定義されたスキルを含む。
• 安全最優先：すべての変更操作に対して「プレビュー→確認」フローを実装し、Wi-FiパスワードやVPNキーなどの機密フィールドをエージェントコンテキストから自動でマスキング（非表示）します。
• 柔軟なデプロイ：ローカル直接実行、AI IDE 用プラグインインストール、リモート管理用のクラウドリレー構造をサポート。