AI导哈

UniFi网络MCP服务器

一个全面的模型上下文协议（MCP）服务器，提供对UniFi网络控制器API的编程访问，使AI助手如Claude能够通过自然语言管理和监控UniFi网络基础设施。

  • by CamoRageaholic1
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 CamoRageaholic1/unifi-mcp-server

使用说明

UniFi网络MCP服务器

一个全面的模型上下文协议（MCP）服务器，提供对UniFi网络控制器API的编程访问。使像Claude这样的人工智能助手能够通过自然语言管理和监控UniFi网络基础设施。

🚀 快速开始

# 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

✨ 特性

9个类别的46个管理工具

  • 📱 设备管理 （13个工具）：列出、重启、采用、升级设备、控制端口和PoE
  • 👥 客户管理 （9个工具）：阻止/解锁、带宽限制、友好名称
  • 🌐 WiFi管理 （6个工具）：配置SSID、密码、安全性
  • 🔧 网络和VLAN （4个工具）：创建VLAN，配置DHCP
  • 🔥 防火墙 （2个工具）：创建规则，过滤流量
  • 🌍 端口转发 （4个工具）：创建/启用/禁用转发
  • 📈 监控 （5个工具）：系统运行状况、统计数据、警报
  • ⚙️ 站点管理 （2个工具）：备份、站点信息
  • 🔌 交换机端口控制：每个端口和PoE管理

📋 安装

看 QUICKSTART.md 5分钟设置指南。

需求

  • Node.js 18+（建议使用20 LTS）
  • UniFi网络控制器（支持API的任何版本）
  • 控制器的网络访问

💬 示例命令

"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"

📚 文档

🔒 安全

  • 基于环境的配置（无硬编码凭据）
  • SSL/TLS验证支持
  • Docker机密兼容
  • 全面的安全文件

📄 许可证

MIT许可证-请参阅许可证文件

创建者：CamoZeroDay

⭐ 如果对你有帮助，请在这个仓库上签名！

相关 MCP