CamoRageaholic1/unifi-mcp-server

UniFi Network MCP Server

A comprehensive Model Context Protocol (MCP) server providing programmatic access to UniFi Network Controller APIs. Enables AI assistants like Claude to manage and monitor UniFi network infrastructure through natural language.

🚀 Quick Start

# 1. Clone and install
git clone https://github.com/CamoRageaholic1/unifi-mcp-server
cd unifi-mcp-server
npm install

# 2. Configure
cp .env.example .env
# Edit .env with your UniFi credentials

# 3. Build and run
npm run build
npm start

✨ Features

46 Management Tools Across 9 Categories

• 📱 Device Management (13 tools): List, restart, adopt, upgrade devices, control ports & PoE
• 👥 Client Management (9 tools): Block/unblock, bandwidth limits, friendly names
• 🌐 WiFi Management (6 tools): Configure SSIDs, passwords, security
• 🔧 Network & VLAN (4 tools): Create VLANs, configure DHCP
• 🔥 Firewall (2 tools): Create rules, filter traffic
• 🌍 Port Forwarding (4 tools): Create/enable/disable forwards
• 📈 Monitoring (5 tools): System health, statistics, alerts
• ⚙️ Site Management (2 tools): Backups, site info
• 🔌 Switch Port Control: Per-port and PoE management

📋 Installation

See for 5-minute setup guide.

Requirements

• Node.js 18+ (20 LTS recommended)
• UniFi Network Controller (any version with API support)
• Network access to controller

💬 Example Commands

"List all my UniFi devices"
"Turn off PoE on port 8"
"Change guest WiFi password to Welcome2024"
"Create VLAN 20 for IoT devices"
"Block client aa:bb:cc:dd:ee:ff"
"Show system health"

📚 Documentation

• - 5-minute setup
• - Architecture overview
• Full README in repository

🔒 Security

• Environment-based configuration (no hardcoded credentials)
• SSL/TLS verification support
• Docker secrets compatible
• Comprehensive security documentation

📄 License

MIT License - See LICENSE file

Created by: CamoZeroDay

⭐ Star this repo if it helps you!