MCPサーバー UniFi

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

特徴

• AIエージェントを通じて自然言語を使用してUniFiサイトとデバイスをクエリする

• UniFi Networkアプリケーションに接続するローカルサーバーの実装

• Goose AIとClaude Desktopの両方と互換性があります

• 安全なAPIキーベースの認証

Related MCP server: UnifiyMe

前提条件

• Python 3.8以上

• uvパッケージマネージャー

• UniFiネットワークアプリケーション

• UniFi APIキー（UniFiコンソールから取得）

設定

1. API キーを作成します。

   • https://unifi.ui.comで UniFi コンソールにアクセスします。

   • 「設定」>「コントロールプレーン」>「統合」に移動します

   • 「APIキーを作成」をクリックします

2. リポジトリをクローンしてセットアップします。

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

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

uv sync

4. 環境変数を設定します。

export UNIFI_API_KEY="your_api_key_here"

サーバーの実行

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

uv run mcp dev main.py

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

AIエージェント統合

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

1. Gooseを開き、「設定」>「拡張機能」>「カスタム拡張機能を追加」に移動します

2. 拡張機能を設定します。

   • ID: ユニフィ

   • 名前: ユニフィ

   • 説明: UniFiネットワークに関する情報を取得します

   • コマンド: /Users/username/.local/bin/uv --directory /path/to/mcp-server-unifi run main.py

   • 環境変数: UNIFI_API_KEY を API キーに設定します

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

1. Claudeを開き、「設定」>「開発者」>「設定の編集」に移動します

2. claude_desktop_config.jsonに追加します:

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