MCPサーバー UniFi

Name: MCP Server UniFi
Author: zcking

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

特徴

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

Related MCP server: MCP Server

前提条件

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" ] } } }