MCP Server Unifi

🚀 UniFi Management Control Protocol (MCP) Server

This is a server implementation for managing and controlling UniFi network devices. It connects to the UniFi network via the MCP (Management Control Protocol). This server allows you to use AI agents (such as Goose and Claude) to interact with your UniFi network in natural language. It encapsulates the UniFi network API.

✨ Features

• Query UniFi sites and devices in natural language through AI agents.
• Local server implementation that connects to the UniFi network application.
• Compatible with Goose AI and Claude Desktop.
• Secure authentication based on API keys.

📋 Prerequisites

• Python 3.8 or higher.
• uv package manager.
• UniFi network application.
• UniFi API key (obtained from the UniFi console).

📦 Installation and Configuration

1. Create an API key:

   • Visit your UniFi console: https://unifi.ui.com
   • Go to Settings » Control Plane » Integrations.
   • Click "Create API Key".

2. Clone and set up the repository:

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

3. Install dependencies:

uv sync

4. Configure environment variables:

export UNIFI_API_KEY="your_api_key_here"

💻 Starting the Server

Start the MCP development server:

uv run mcp dev main.py

The MCP checker tool will be available at http://localhost:5173 for testing and debugging.

🤖 AI Agent Integration

Goose AI Setup

1. Open Goose and go to Settings » Extensions » Add Custom Extension.
2. Configure the extension:
   • ID: unifi
   • Name: unifi
   • Description: Get information about your UniFi network.
   • Command: /Users/username/.local/bin/uv --directory /path/to/mcp-server-unifi run main.py
   • Environment variables: Set UNIFI_API_KEY to your API key.

Claude Desktop Setup

1. Open Claude and go to Settings » Developer » Edit Configuration.
2. Add the following to claude_desktop_config.json:

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