MMCPMarkets
SU

swkstudios/unifi-fabric-mcp-server

部署与 DevOps

本页由 AI 翻译，技术细节请以原文为准。 查看原文

5 stars 4 forks 质量 78 趋势 21MIT
Repository Install

MCP server for UniFi Fabric API: manage your entire UniFi network through any AI assistant remotely

概览

This server connects to the official UniFi Site Manager / Fabric cloud API (api.ui.com) — no direct controller access, SSH, or local network access required. Manage your entire UniFi fleet from anywhere through natural language. An MCP (Model Context Protocol) server that exposes the UniFi Site Manager API as tools for AI assistants. Built with FastMCP, it lets Claude Code, Cline, and other MCP clients manage UniFi network infrastructure through natural language. This project is not affiliated with, endorsed by, or sponsored by Ubiquiti Inc. UniFi is a trademark of Ubiquiti Inc. - 283 tools across Fleet, Network, Firewall, Protect, VPN, InnerSpace, History, and more - Faithful pass-through — tools return complete upstream payloads including credential fields (WLAN passphrases, RADIUS secrets, API tokens), GPS coordinates, and Protect recognition data. The include_secrets and include_gps parameters have been removed; all fields are always returned. Callers upgrading from 0.4.

README

以下为原文 README 节选，完整内容请查看原文。

UniFi Fabric MCP Server

Cloud-first UniFi management for AI agents. This server connects to the official UniFi Site Manager / Fabric cloud API (api.ui.com) — no direct controller access, SSH, or local network access required. Manage your entire UniFi fleet from anywhere through natural language.

An MCP (Model Context Protocol) server that exposes the UniFi Site Manager API as tools for AI assistants. Built with FastMCP, it lets Claude Code, Cline, and other MCP clients manage UniFi network infrastructure through natural language.

Disclaimer: This project is not affiliated with, endorsed by, or sponsored by Ubiquiti Inc. UniFi is a trademark of Ubiquiti Inc.

Highlights:

  • 283 tools across Fleet, Network, Firewall, Protect, VPN, InnerSpace, History, and more
  • Faithful pass-through — tools return complete upstream payloads including credential fields (WLAN passphrases, RADIUS secrets, API tokens), GPS coordinates, and Protect recognition data. The include_secrets and include_gps parameters have been removed; all fields are always returned. Callers upgrading from 0.4.x or earlier should drop those parameters.
  • Configurable authentication: none (loopback/dev) / bearer (LAN/VPN) / oauth (resource-server, JWT-verified via JWKS)
  • Configurable TLS: plain HTTP / in-server HTTPS (https) / mutual TLS (mtls)
  • Stdio transport for local use; streamable-http / sse for containerized deployments
  • Stateless, cloud-first design — connects to api.ui.com via the UniFi Site Manager API; no direct controller access required

Architecture

flowchart LR
    A[AI AssistantMCP Client] -->|MCP protocolstdio / HTTP| B[UniFi FabricMCP Server]
    B -->|HTTPSAPI key auth| C[api.ui.comUniFi Site Manager]
    C -->|Cloud ConnectorProxy| D[UDM / UDR / UCGConsoles]
    D --- E[Devices & Clients]
    D --- F[Protect NVRs]

What is MCP?

Model Context Protocol (MCP) is an open standard that enables large language models (LLMs) and AI assistants to securely interact with external systems and tools. Instead of asking the AI to make manual API calls or describe steps, MCP allows the AI to:

  • Execute commands and operations directly in external systems
  • Query data and retrieve real-time information
  • Automate complex workflows through natural conversation

This UniFi Fabric MCP server bridges UniFi’s network management API with AI assistants, enabling you to control your network infrastructure through conversation.

在 GitHub 查看完整 README

安装

docker run --rm -i -e UNIFI_API_KEY=your-api-key-here -e FASTMCP_TRANSPORT=stdio ghcr.io/swkstudios/unifi-fabric-mcp-server:0.6.1
新手？先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "unifi-fabric": { "command": "unifi-fabric-mcp", "env": { "UNIFI_API_KEY": "your-api-key-here" } } } }