UniFi Network MCP Server

@sirkirby

代码仓库

基本信息

分类

其他

许可证

MIT license

传输方式

stdio

作者

sirkirby

关于 UniFi Network MCP Server

MCP server implementation for the UniFi network application

#unifi#mcp-server

UniFi Network MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "unifi-network-mcp": {
      "command": "docker",
      "args": [
        "pull",
        "ghcr.io/sirkirby/unifi-network-mcp:latest"
      ]
    }
  }
}

UniFi Network MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is UniFi Network MCP Server?

A self-hosted Model Context Protocol (MCP) server that turns your UniFi Network Controller into a programmable set of tools. It exposes every capability as standard MCP tools prefixed with unifi_, so any LLM or agent speaking MCP (e.g., Claude Desktop, mcp-cli, LangChain) can query, analyse, and – when explicitly confirmed – modify your network.

How to use UniFi Network MCP Server?

Run via Docker using ghcr.io/sirkirby/unifi-network-mcp:latest, or install locally with Python/UV (uv pip install unifi-network-mcp) then launch the mcp-server-unifi-network command. Supply UniFi controller credentials through environment variables (UNIFI_HOST, UNIFI_USERNAME, UNIFI_PASSWORD, etc.) or an .env file. Integrate with Claude Desktop by adding the server to your claude_desktop_config.json.

Key features of UniFi Network MCP Server

Full catalog of UniFi controller operations (firewall, traffic-routes, port-forwards, QoS, VPN, WLANs, stats, devices, clients).
All mutating tools require confirm=true to prevent accidental changes.
Works over stdio (FastMCP) and exposes an SSE HTTP endpoint (default port 3000).
One-liner launch via the console-script mcp-server-unifi-network.
Python ≥ 3.10, packaged with pyproject.toml and available on PyPI.

Use cases of UniFi Network MCP Server

Query and analyse network statistics, device lists, and client activity through natural language.
Create, update, or toggle firewall policies and port forwards with explicit user confirmation.
Block/unblock clients, rename devices, and reboot equipment via an LLM agent.
Automate VPN client and server configuration changes.
Retrieve alerts and network health without logging into the controller UI.

常见问题

What does this server do vs alternatives?

It is an MCP server, not a UniFi controller. It translates MCP tool calls into UniFi controller API operations, enabling any MCP-compatible LLM or agent to interact with your network.

What are the runtime requirements?

You need either Docker (to run the pre-built image) or Python ≥3.10 with `uv`/`pip`. The server must be able to reach a UniFi Network Controller over HTTPS.

Where does my network data live?

All data remains in the UniFi controller. The server acts as a pass-through and does not store any network configuration or client data.

Which transport protocols are supported?

The server supports both **stdio** (default for MCP) and **SSE HTTP** (on port 3000 by default). Configuration is set in `src/config/config.yaml`.

How do I authenticate to the UniFi controller?

Credentials are supplied via environment variables (`UNIFI_HOST`, `UNIFI_USERNAME`, `UNIFI_PASSWORD`, `UNIFI_PORT`, `UNIFI_SITE`, `UNIFI_VERIFY_SSL`) or an `.env` file. No additional authentication layer is provided for the MCP transport.