unifi-network-mcp

unifi-network-mcp

1
securityos_automationcommunicationnetwork_management

UniFi Network MCP Server is a self-hosted server that turns a UniFi Network Controller into a programmable toolset using the Model Context Protocol. It provides comprehensive operations for managing network components such as firewalls, devices, and VPNs, with a secure confirmation mechanism for changes.

📡 UniFi Network MCP Server

A self-hosted MCP server for converting a UniFi Network Controller into programmable tools with operations like firewall, traffic routes, port-forwards, VPN, etc. It requires confirmation for all changes and works via stdio or an SSE HTTP endpoint.

Features

  • Full catalog of UniFi controller operations.
  • Change operations require confirm=true.
  • Supports stdio and SSE HTTP with fast launch options.
  • Compatible with Python ≥ 3.10 and PyPI.

Quick Start

  • Docker: Provides commands to pull and run the image.
  • Python/UV: Steps to clone, create a virtual environment, and launch.
  • PyPI: Install command when published.

Runtime Configuration

  • Merges settings from environment variables, an optional .env file, and config.yaml.

📚 Tool Catalog

  • State-changing tools require confirm=true.
  • Categories: Firewall, Traffic Routes, Port Forwarding, QoS/Traffic Shaping, Networks & WLANs, VPN, Devices, Clients, Statistics & Alerts, System.

Contributing: Releasing / Publishing

  • Uses PyPI Trusted Publishing via GitHub Actions workflow.