UniFi Network MCP

Name: UniFi Network MCP
Author: sirkirby

sirkirby

开始使用源码仓库

Manage UniFi Network devices, clients, firewall, VLANs, VPNs, and more via MCP.

接入配置

选择客户端，复制配置，再按项目文档补齐环境变量。

一键添加到 Cursor 一键添加到 VS Code

claude mcp add unifi-network --env UNIFI_HOST='<UNIFI_HOST>' --env UNIFI_USERNAME='<UNIFI_USERNAME>' --env UNIFI_PASSWORD='<UNIFI_PASSWORD>' --env UNIFI_API_KEY='<UNIFI_API_KEY>' --env UNIFI_NETWORK_HOST='<UNIFI_NETWORK_HOST>' --env UNIFI_NETWORK_USERNAME='<UNIFI_NETWORK_USERNAME>' --env UNIFI_NETWORK_PASSWORD='<UNIFI_NETWORK_PASSWORD>' -- uvx unifi-network-mcp

~/.codex/config.toml

[mcp_servers.unifi-network]
command = "uvx"
args = ["unifi-network-mcp"]
env = { UNIFI_HOST = "<UNIFI_HOST>", UNIFI_USERNAME = "<UNIFI_USERNAME>", UNIFI_PASSWORD = "<UNIFI_PASSWORD>", UNIFI_API_KEY = "<UNIFI_API_KEY>", UNIFI_NETWORK_HOST = "<UNIFI_NETWORK_HOST>", UNIFI_NETWORK_USERNAME = "<UNIFI_NETWORK_USERNAME>", UNIFI_NETWORK_PASSWORD = "<UNIFI_NETWORK_PASSWORD>" }

# codex mcp add unifi-network --env UNIFI_HOST='<UNIFI_HOST>' --env UNIFI_USERNAME='<UNIFI_USERNAME>' --env UNIFI_PASSWORD='<UNIFI_PASSWORD>' --env UNIFI_API_KEY='<UNIFI_API_KEY>' --env UNIFI_NETWORK_HOST='<UNIFI_NETWORK_HOST>' --env UNIFI_NETWORK_USERNAME='<UNIFI_NETWORK_USERNAME>' --env UNIFI_NETWORK_PASSWORD='<UNIFI_NETWORK_PASSWORD>' -- uvx unifi-network-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "unifi-network": {
      "command": "uvx",
      "args": [
        "unifi-network-mcp"
      ],
      "env": {
        "UNIFI_HOST": "<UNIFI_HOST>",
        "UNIFI_USERNAME": "<UNIFI_USERNAME>",
        "UNIFI_PASSWORD": "<UNIFI_PASSWORD>",
        "UNIFI_API_KEY": "<UNIFI_API_KEY>",
        "UNIFI_NETWORK_HOST": "<UNIFI_NETWORK_HOST>",
        "UNIFI_NETWORK_USERNAME": "<UNIFI_NETWORK_USERNAME>",
        "UNIFI_NETWORK_PASSWORD": "<UNIFI_NETWORK_PASSWORD>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "unifi-network": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "unifi-network-mcp"
      ],
      "env": {
        "UNIFI_HOST": "<UNIFI_HOST>",
        "UNIFI_USERNAME": "<UNIFI_USERNAME>",
        "UNIFI_PASSWORD": "<UNIFI_PASSWORD>",
        "UNIFI_API_KEY": "<UNIFI_API_KEY>",
        "UNIFI_NETWORK_HOST": "<UNIFI_NETWORK_HOST>",
        "UNIFI_NETWORK_USERNAME": "<UNIFI_NETWORK_USERNAME>",
        "UNIFI_NETWORK_PASSWORD": "<UNIFI_NETWORK_PASSWORD>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "unifi-network": {
      "command": "uvx",
      "args": [
        "unifi-network-mcp"
      ],
      "env": {
        "UNIFI_HOST": "<UNIFI_HOST>",
        "UNIFI_USERNAME": "<UNIFI_USERNAME>",
        "UNIFI_PASSWORD": "<UNIFI_PASSWORD>",
        "UNIFI_API_KEY": "<UNIFI_API_KEY>",
        "UNIFI_NETWORK_HOST": "<UNIFI_NETWORK_HOST>",
        "UNIFI_NETWORK_USERNAME": "<UNIFI_NETWORK_USERNAME>",
        "UNIFI_NETWORK_PASSWORD": "<UNIFI_NETWORK_PASSWORD>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "unifi-network": {
      "command": "uvx",
      "args": [
        "unifi-network-mcp"
      ],
      "env": {
        "UNIFI_HOST": "<UNIFI_HOST>",
        "UNIFI_USERNAME": "<UNIFI_USERNAME>",
        "UNIFI_PASSWORD": "<UNIFI_PASSWORD>",
        "UNIFI_API_KEY": "<UNIFI_API_KEY>",
        "UNIFI_NETWORK_HOST": "<UNIFI_NETWORK_HOST>",
        "UNIFI_NETWORK_USERNAME": "<UNIFI_NETWORK_USERNAME>",
        "UNIFI_NETWORK_PASSWORD": "<UNIFI_NETWORK_PASSWORD>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "unifi-network": {
      "command": "uvx",
      "args": [
        "unifi-network-mcp"
      ],
      "env": {
        "UNIFI_HOST": "<UNIFI_HOST>",
        "UNIFI_USERNAME": "<UNIFI_USERNAME>",
        "UNIFI_PASSWORD": "<UNIFI_PASSWORD>",
        "UNIFI_API_KEY": "<UNIFI_API_KEY>",
        "UNIFI_NETWORK_HOST": "<UNIFI_NETWORK_HOST>",
        "UNIFI_NETWORK_USERNAME": "<UNIFI_NETWORK_USERNAME>",
        "UNIFI_NETWORK_PASSWORD": "<UNIFI_NETWORK_PASSWORD>"
      }
    }
  }
}

需要的环境变量

UNIFI_HOST
UNIFI_USERNAME
UNIFI_PASSWORD
UNIFI_API_KEY
UNIFI_NETWORK_HOST
UNIFI_NETWORK_USERNAME
UNIFI_NETWORK_PASSWORD

把占位值换成你自己的密钥；不要把密钥提交到代码仓库。

接入配置

需要的环境变量

相关推荐