What is Mcp Server Unifi

mcp-server-unifi is a server implementation designed to manage and control UniFi network devices using the Management Control Protocol (MCP). It allows users to interact with their UniFi network through natural language via AI agents like Goose and Claude.

Use cases

Use cases for mcp-server-unifi include simplifying network management tasks through natural language queries, automating network monitoring and reporting, and enhancing user experience by providing intuitive interactions with network devices.

How to use

To use mcp-server-unifi, you need to set up the server by creating an API key in your UniFi console, cloning the repository, installing dependencies, and configuring environment variables. Once set up, you can run the server and integrate it with AI agents for natural language interactions.

Key features

Key features include querying UniFi sites and devices using natural language, a local server implementation that connects to the UniFi Network application, compatibility with Goose AI and Claude Desktop, and secure API key-based authentication.

Where to use

mcp-server-unifi can be used in various fields where network management is essential, such as IT departments, educational institutions, and businesses that utilize UniFi network devices for connectivity.

MCP Server UniFi

A server implementation for managing and controlling UniFi network devices through MCP (Management Control Protocol). This server enables natural language interactions with your UniFi network using AI agents like Goose and Claude by wrapping the UniFi Network API.

Features

• Query UniFi sites and devices using natural language through AI agents
• Local server implementation that connects to your UniFi Network application
• Compatible with both Goose AI and Claude Desktop
• Secure API key-based authentication

Prerequisites

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

Setup

1. Create an API key:

   • Go to your UniFi console at https://unifi.ui.com
   • Navigate 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  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows

3. Install dependencies:

uv sync

4. Configure environment variables:

export UNIFI_API_KEY="your_api_key_here"

Running the Server

Start the MCP development server:

uv run mcp dev main.py

The MCP Inspector 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 Config
2. Add to your claude_desktop_config.json:

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