MCP Server Unifi

🚀 UniFi 管理制御プロトコル (MCP) サーバー

UniFi管理制御プロトコル (MCP) サーバーは、MCP（管理制御プロトコル）を通じてUniFiネットワークに接続し、UniFiネットワーク機器の管理と制御を行うサーバー実装です。このサーバーを使用すると、GooseやClaudeなどのAIエージェントを通じて自然言語でUniFiネットワークと対話できます。また、UniFiネットワークAPIをラッピングしています。

✨ 主な機能

• AIエージェントを通じて、自然言語でUniFiサイトやデバイスを照会できます。
• ローカルサーバーで実装され、UniFiネットワークアプリケーションに接続できます。
• Goose AI と Claude Desktop と互換性があります。
• APIキーに基づく安全な認証方式を採用しています。

📦 インストール

前提条件

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

インストールと設定手順

1. APIキーの作成：

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

2. リポジトリのクローンと設定：

git clone https://github.com/zcking/mcp-server-unifi
cd mcp-server-unifi
uv venv
source .venv/bin/activate  # Unix/macOS システム
# または
.venv\Scripts\activate  # 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エージェントの統合

Goose AIの設定

1. Gooseを開き、設定 » 拡張機能 » カスタム拡張機能の追加 へ移動します。
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を開き、設定 » 開発者 » 設定の編集 へ移動します。
2. claude_desktop_config.json に以下の内容を追加します：

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