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

Related MCP server: UniFi MCP Server

✨ 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 QUICKSTART.md 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

• QUICKSTART.md - 5-minute setup

• PROJECT_SUMMARY.md - 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!