SU

swkstudios/unifi-fabric-mcp-server

Deployment & DevOps

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

5 stars 4 forks 品質 78 トレンド 21MIT

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
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

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