mcp
通过自然语言管理 UniFi 网络设备的 AI 代理工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：mcp。 它的用途是：通过自然语言管理 UniFi 网络设备的 AI 代理工具 详细介绍见：https://321skill.com/skills/mcp-mcp-server-unifi/ 请根据该页面的说明完成安装。
使用示例
“帮我检查一下二楼会议室AP的客户端连接状态，如果用户‘Guest-Phone’在线，就暂时断开它的连接。” 它会通过 MCP 服务器查询指定 AP 的详情，找到目标客户端并执行断开操作，然后将结果反馈给你。或者
对AI说：“列出所有离线超过1小时的设备。” 它会从 UniFi 控制器获取设备列表并进行筛选，以清晰的格式告诉你哪些设备可能出现了问题。
介绍
这个 Skill 解决了网络管理员或 IT 运维人员需要通过命令行或 Web 界面手动操作来管理 UniFi 网络设备（如 AP、交换机、网关）的繁琐问题。它提供了一个 MCP（Model Context Protocol）服务器，允许你直接通过自然语言向 AI 助手（如 Claude）下达指令来执行常见的网络管理任务。
使用方式非常简单：首先在你的环境中安装并运行这个 MCP 服务器，配置好你的 UniFi 控制器地址和凭据。之后，在你支持的 AI 助手工具（如 Claude Desktop）中，你就可以像与同事对话一样，用中文或英文描述你的需求，例如“查看当前有哪些客户端在线”或“重启一下三楼的 AP”。
它非常适合需要频繁管理 UniFi 网络的运维工程师、中小企业的 IT 管理员，以及对自动化运维感兴趣的技术爱好者。这些人通常需要快速响应网络问题或进行日常维护，但又不希望每次都登录控制器界面进行点击操作。
使用建议是，请确保在安全的网络环境下运行此服务器，并妥善保管你的 UniFi 控制器 API 密钥。由于它直接操作网络设备，建议在非核心业务时段先进行测试性指令，熟悉其交互逻辑。对于复杂的网络配置变更，建议仍通过官方控制器进行复核。
核心特点
这是首个将 MCP 协议与 UniFi 设备管理深度结合的 Skill，实现了对 UniFi 生态系统的自然语言控制。与通用的网络自动化脚本相比，它无需用户编写任何代码，通过对话即可完成设备状态查询、客户端管理、设备重启等操作，极大降低了使用门槛。
注意事项
不适合需要复杂策略配置（如防火墙规则、流量整形）或进行大规模网络架构变更的场景。
常见问题
支持哪些 UniFi 设备？
支持通过 UniFi Network 应用管理的所有设备，包括 AP、交换机、安全网关等。
需要 Claude 才能用吗？
核心是一个 MCP 服务器，任何支持 MCP 协议的 AI 助手（如 Claude Desktop, Cursor）都可以调用它。