enuno/unifi-mcp-server

An MCP server that leverages official UniFi API

解决的问题

管理UniFi网络基础设施通常需要手动浏览复杂的Web界面。本项目为AI代理与UniFi硬件交互提供了一种标准化方式,使其能够通过模型上下文协议(MCP)自动读取网络数据、调整配置并管理设备。

工作原理

该服务器充当AI客户端(如Claude Desktop或Cursor)与UniFi控制器之间的桥梁。它将数百个特定工具(如网络设置、防火墙规则、摄像头管理和设备诊断)暴露为标准化命令。您可以以“本地”模式运行以控制自己的硬件,或连接UniFi云API进行聚合站点管理。它包含安全功能,如强制确认更改、试运行模式和基于角色的访问控制。

适用对象

该工具专为网络管理员、家庭实验室爱好者和希望使用AI自动化UniFi基础设施的开发者设计。对于希望通过自然语言提示执行复杂任务(如审计防火墙规则、规划WiFi频道或管理多站点部署)的用户尤为有用。

亮点

  • 提供超过300个工具,全面控制UniFi Network、Protect和云服务。
  • 支持“Fleet模式”,通过单一界面管理多个控制器,并具有集中日志记录和缓存功能。
  • 内置安全机制,包括审计日志、试运行能力和基于风险等级的访问控制。
  • 提供专门的“代理技能”(Markdown文件),帮助AI代理有效理解和执行网络任务。
  • 高度可观测,支持Prometheus指标、SIEM导出和Webhook集成。

相关

  • 项目
  • 项目
  • 项目
  • 项目