MCPサーバー UniFi

MCP（Management Control Protocol）を介してUniFiネットワークデバイスを管理・制御するためのサーバー実装。このサーバーは、UniFi Network APIをラップすることで、GooseやClaudeなどのAIエージェントを使用してUniFiネットワークとの自然言語によるインタラクションを可能にします。

特徴

AIエージェントを通じて自然言語を使用してUniFiサイトとデバイスをクエリする
UniFi Networkアプリケーションに接続するローカルサーバーの実装
Goose AIとClaude Desktopの両方と互換性があります
安全なAPIキーベースの認証

前提条件

Python 3.8以上
uvパッケージマネージャー
UniFiネットワークアプリケーション
UniFi APIキー（UniFiコンソールから取得）

設定

API キーを作成します。
- https://unifi.ui.comで UniFi コンソールにアクセスします。
- 「設定」>「コントロールプレーン」>「統合」に移動します
- 「APIキーを作成」をクリックします
リポジトリをクローンしてセットアップします。

git clone https://github.com/zcking/mcp-server-unifi
cd mcp-server-unifi
uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows

依存関係をインストールします:

uv sync

環境変数を設定します。

export UNIFI_API_KEY="your_api_key_here"

サーバーの実行

MCP 開発サーバーを起動します。

uv run mcp dev main.py

MCP インスペクターは、テストとデバッグのためにhttp://localhost:5173で利用できます。

AIエージェント統合

ガチョウAIのセットアップ

Gooseを開き、「設定」>「拡張機能」>「カスタム拡張機能を追加」に移動します
拡張機能を設定します。
- ID: ユニフィ
- 名前: ユニフィ
- 説明: UniFiネットワークに関する情報を取得します
- コマンド: /Users/username/.local/bin/uv --directory /path/to/mcp-server-unifi run main.py
- 環境変数: UNIFI_API_KEY を API キーに設定します

クロードデスクトップセットアップ

Claudeを開き、「設定」>「開発者」>「設定の編集」に移動します
claude_desktop_config.jsonに追加します:

{
    "mcpServers": {
        "unifi": {
            "command": "/Users/username/.local/bin/uv",
            "args": [
                "--directory",
                "/path/to/mcp-server-unifi",
                "run",
                "main.py"
            ]
        }
    }
}

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Goose や Claude などの AI エージェント用の UniFi Network API をラップすることで、UniFi ネットワークデバイスとの自然言語による対話を可能にするサーバー実装。

MCP Server UniFi