UniFi Safe MCP

UniFi Network に特化した読み取り専用の MCP サーバーで、ヘルス、デバイス、アクティブクライアントのビューを制限付きで提供します。spectrenet-mcp のコミット 2e63f009d8f4642e17398685baef0251811d6637 から抽出されたもので、このリポジトリは自己完結型です。

安全契約

• 読み取りツールは network_health、devices、clients の3つのみ。設定、コマンド、採用、再起動、ブロック、その他の変更ツールはありません。

• アプライアンスデータのリクエストは HTTP GET のみを使用します（認証は必然的に POST /api/auth/login を使用します）。

• TLS 証明書とホスト名の検証はデフォルトで有効です。

• 認証およびアプライアンスデータのリダイレクトは、フォローせず拒否されます。

• 設定されたサイトは1つの URL パスセグメントとしてエンコードされ、エンドポイントのサフィックスはクローズド許可リストに登録されています。

• HTTP レスポンスのバイト数、返されるリストの長さ、投影フィールド、監査フィールドは制限されています。

• 資格情報と完全なレスポンスは監査されません。

Related MCP server: UniFi MCP Server

互換性

これは、最新の UniFi OS アプライアンスで確認された UniFi OS コンソールプロキシパス /api/auth/login と /proxy/network/api/s/{site}/... を対象としています。古い自己ホスト型の UniFi Network Controller は通常 /api/login と非プロキシの /api/s/... を使用しますが、これらはサポートされていません。Ubiquiti はアプライアンスと Network Application のバージョン間でプライベート/内部エンドポイントを変更します。認定されたバージョンマトリックスはありません。このアルファ版を、非本番環境でお使いの正確なコンソールファームウェアと Network Application バージョンに対してテストし、アップグレードは運用上固定してください。

インストールと実行

uv sync --extra test
uv run unifi-safe-mcp --help
uv run unifi-safe-mcp

サーバーは MCP stdio を使用し、.env を読み込みません。.env.example はダミーのドキュメントとしてのみ扱い、専用の読み取り専用アカウントをスーパーバイザー/シークレットマネージャーを通じて注入してください。

検証

uv sync --locked --extra test
uv run --locked pytest
uv run --locked python -m compileall -q src tests
uv build

アーキテクチャ、互換性、セキュリティ を参照してください。MIT © 2026 Ben Gauger.