Go Unifi MCP
G

Go Unifi MCP

一个用于 UniFi 网络控制器的 MCP 服务器,提供对 UniFi 基础设施(包括防火墙规则和 IPv6)的 AI 助手访问接口,支持 API 密钥和用户名/密码两种认证方式。
2分
0

什么是 go-unifi-mcp?

go-unifi-mcp 是一个连接 AI 助手与 UniFi 网络设备的桥梁。它允许您通过自然语言或简单的命令来管理您的 UniFi 网络,无需登录复杂的控制面板。

如何使用 go-unifi-mcp?

只需配置好您的 UniFi 控制器连接信息,然后在 Claude Desktop 或 Claude Code 中启用此 MCP 服务器,您就可以直接询问 AI 助手关于网络状态、设备信息,甚至执行管理操作。

适用场景

适合家庭用户、小型企业管理员或任何使用 UniFi 网络设备并希望通过 AI 助手简化管理流程的用户。特别适合快速查询网络状态、设备列表、管理访客网络等日常任务。

主要功能

完整的 UniFi API 覆盖
支持 242 个 UniFi 操作,涵盖设备管理、网络配置、防火墙规则、用户管理等各个方面
智能工具模式
提供两种工具注册模式:Lazy 模式(推荐)仅注册 3 个元工具,节省上下文空间;Eager 模式注册所有工具,适合调试
ID 自动解析
自动将 API 返回的复杂 ID 转换为易读的名称,让响应更直观易懂
灵活的查询过滤
支持按字段过滤、全文搜索和字段投影,让您精确获取所需信息
多平台支持
提供二进制文件、Docker 镜像、Homebrew 和 Nix 包,支持 macOS 和 Linux 系统
IPv6 和防火墙规则支持
完整支持 IPv6 和 v1/v2 防火墙规则,满足现代网络需求
优势
基于官方 go-unifi 库开发,API 覆盖全面且稳定
智能工具模式大幅减少 AI 助手的上下文占用
ID 自动解析功能让响应更易理解
支持多种安装方式,部署简单
持续更新,跟随 UniFi 控制器版本演进
局限性
需要 UniFi 控制器和相应的访问权限
更新操作采用读-修改-写流程,非原子操作
某些高级功能可能需要技术背景理解
目前仅支持命令行和 AI 助手集成,无独立 GUI

如何使用

获取访问凭证
在 UniFi 控制器中创建 API 密钥(推荐)或准备管理员账号密码
安装服务器
选择适合您系统的安装方式,如使用 Homebrew、Docker 或直接下载二进制文件
配置 Claude Desktop
编辑 Claude Desktop 配置文件,添加 MCP 服务器配置
开始使用
重启 Claude Desktop,现在您可以直接询问 AI 助手关于 UniFi 网络的问题了

使用案例

快速网络状态检查
当您想了解网络整体状态时,可以快速查询设备信息和客户端连接情况
访客网络管理
为访客创建临时网络或管理现有访客网络
设备故障排查
当某个设备连接有问题时,快速查看其详细信息和连接状态
批量设备管理
对多个设备执行相同操作,如重启、重命名或重新配置

常见问题

我需要什么样的 UniFi 控制器版本?
Lazy 模式和 Eager 模式有什么区别?
API 密钥和用户名密码哪种认证方式更好?
为什么有时候响应中会有 _name 字段?
如何过滤查询结果?
更新操作安全吗?会不会覆盖其他人的修改?

相关资源

GitHub 仓库
项目源代码、问题跟踪和最新版本
go-unifi 库
本项目依赖的 UniFi Go 客户端库
UniFi 官方文档
UniFi 网络设备的官方文档和支持
Model Context Protocol
MCP 协议官方规范
Docker 镜像
官方 Docker 镜像仓库

安装

复制以下命令到你的Client进行配置
{
  "mcpServers": {
    "unifi": {
      "command": "/usr/local/bin/go-unifi-mcp",
      "env": {
        "UNIFI_HOST": "https://your-controller:443",
        "UNIFI_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "unifi": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "UNIFI_HOST",
        "-e",
        "UNIFI_API_KEY",
        "ghcr.io/claytono/go-unifi-mcp:latest"
      ],
      "env": {
        "UNIFI_HOST": "https://your-controller:443",
        "UNIFI_API_KEY": "your-api-key"
      }
    }
  }
}
注意:您的密钥属于敏感信息,请勿与任何人分享。

替代品

V
Vestige
Vestige是一个基于认知科学的AI记忆引擎,通过实现预测误差门控、FSRS-6间隔重复、记忆梦境等29个神经科学模块,为AI提供长期记忆能力。包含3D可视化仪表板和21个MCP工具,完全本地运行,无需云端。
Rust
4.3K
4.5分
M
Moltbrain
MoltBrain是一个为OpenClaw、MoltBook和Claude Code设计的长期记忆层插件,能够自动学习和回忆项目上下文,提供智能搜索、观察记录、分析统计和持久化存储功能。
TypeScript
5.0K
4.5分
B
Bm.md
一个功能丰富的Markdown排版工具,支持多种样式主题和平台适配,提供实时编辑预览、图片导出和API集成能力
TypeScript
3.4K
5分
S
Security Detections MCP
Security Detections MCP 是一个基于Model Context Protocol的服务器,允许LLM查询统一的安全检测规则数据库,涵盖Sigma、Splunk ESCU、Elastic和KQL格式。最新3.0版本升级为自主检测工程平台,可自动从威胁情报中提取TTPs、分析覆盖差距、生成SIEM原生格式检测规则、运行测试并验证。项目包含71+工具、11个预构建工作流提示和知识图谱系统,支持多SIEM平台。
TypeScript
6.0K
4分
P
Paperbanana
PaperBanana是一个自动化生成学术图表和统计图的智能框架,支持从文本描述生成高质量的论文插图,采用多智能体管道和迭代优化,提供CLI、Python API和MCP服务器等多种使用方式。
Python
7.5K
5分
B
Better Icons
一个提供超过20万图标搜索和检索的MCP服务器和CLI工具,支持150多个图标库,帮助AI助手和开发者快速获取和使用图标。
TypeScript
5.6K
4.5分
A
Assistant Ui
assistant-ui是一个开源TypeScript/React库,用于快速构建生产级AI聊天界面,提供可组合的UI组件、流式响应、无障碍访问等功能,支持多种AI后端和模型。
TypeScript
7.2K
5分
A
Apify MCP Server
Apify MCP服务器是一个基于模型上下文协议(MCP)的工具,允许AI助手通过数千个现成的爬虫、抓取器和自动化工具(Apify Actor)从社交媒体、搜索引擎、电商等网站提取数据。它支持OAuth和Skyfire代理支付,可通过HTTPS端点或本地stdio方式集成到Claude、VS Code等MCP客户端中。
TypeScript
7.4K
5分
F
Figma Context MCP
Framelink Figma MCP Server是一个为AI编程工具(如Cursor)提供Figma设计数据访问的服务器,通过简化Figma API响应,帮助AI更准确地实现设计到代码的一键转换。
TypeScript
75.5K
4.5分
D
Duckduckgo MCP Server
已认证
DuckDuckGo搜索MCP服务器,为Claude等LLM提供网页搜索和内容抓取服务
Python
85.5K
4.3分
F
Firecrawl MCP Server
Firecrawl MCP Server是一个集成Firecrawl网页抓取能力的模型上下文协议服务器,提供丰富的网页抓取、搜索和内容提取功能。
TypeScript
149.9K
5分
E
Edgeone Pages MCP Server
EdgeOne Pages MCP是一个通过MCP协议快速部署HTML内容到EdgeOne Pages并获取公开URL的服务
TypeScript
33.0K
4.8分
B
Baidu Map
已认证
百度地图MCP Server是国内首个兼容MCP协议的地图服务,提供地理编码、路线规划等10个标准化API接口,支持Python和Typescript快速接入,赋能智能体实现地图相关功能。
Python
50.1K
4.5分
C
Context7
Context7 MCP是一个为AI编程助手提供实时、版本特定文档和代码示例的服务,通过Model Context Protocol直接集成到提示中,解决LLM使用过时信息的问题。
TypeScript
105.7K
4.7分
E
Exa Web Search
已认证
Exa MCP Server是一个为AI助手(如Claude)提供网络搜索功能的服务器,通过Exa AI搜索API实现实时、安全的网络信息获取。
TypeScript
56.1K
5分
M
Minimax MCP Server
MiniMax Model Context Protocol (MCP) 是一个官方服务器,支持与强大的文本转语音、视频/图像生成API交互,适用于多种客户端工具如Claude Desktop、Cursor等。
Python
64.6K
4.8分
AIBase
智启未来,您的人工智能解决方案智库
© 2026AIBase