MCP Server UniFi

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 Network アプリケーション
• UniFi API キー（UniFi コンソールから取得）

セットアップ

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

   • https://unifi.ui.com の UniFi コンソールにアクセスします
   • Settings » Control Plane » Integrations に移動します
   • "Create API Key" をクリックします

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

テストとデバッグには、http://localhost:5173 から MCP Inspector を利用できます。

AI エージェントとの統合

Goose AI のセットアップ

1. Goose を開き、Settings » Extensions » Add custom extension に移動します
2. 拡張機能を設定します：
   • ID：unifi
   • 名前：unifi
   • 説明：UniFi ネットワークに関する情報を取得します
   • コマンド：/Users/username/.local/bin/uv --directory /path/to/mcp-server-unifi run main.py
   • 環境変数：UNIFI_API_KEY に API キーを設定します

Claude Desktop のセットアップ

1. Claude を開き、Settings » Developer » Edit Config に移動します
2. claude_desktop_config.json に追加します：

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