AI导哈

UDM Pro管理协议服务器

UDM Pro MCP Server是一个模型上下文协议服务器，允许Claude Code管理和监控Ubiquiti UDM Pro设备，提供46种工具覆盖监控、设备、客户端、网络和系统五大类别。

  • by czinda
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 czinda/udm-pro-mcp

使用说明

UDM Pro MCP服务器

一个MCP（模型上下文协议）服务器，允许Claude Code管理和监视Ubiquiti UDM Pro。

特征

46工具 分为五类：

  • 监控 （12个工具）--站点运行状况、活动客户端、DPI统计数据、事件、流量报告、广域网信息、系统信息
  • 设备 （10个工具）——列出、检查、重启、升级、采用、定位、PoE电源循环、速度测试
  • 客户 （6个工具）--阻止/取消阻止、断开连接、访客授权、重命名
  • 网络 （12个工具）——网络/VLAN、WLAN、防火墙规则、端口转发（CRUD）
  • 系统 （6个工具）--重启、备份、报警管理、DDNS状态、syslog

设置

1.安装

cd ~/git/udm-pro-mcp
pip install -e .

2.配置

创建 ~/.udm-pro-mcp/config.json:

{
  "host": "192.168.1.1",
  "port": 443,
  "username": "admin",
  "password": "your-password",
  "site": "default",
  "verify_ssl": false
}

用覆盖配置路径 UDM_MCP_CONFIG 环境变量。

3.添加到克劳德代码

claude mcp add --transport stdio udm-pro -- udm-pro-mcp

4.验证

跑 /mcp 在Claude Code中确认服务器已连接，并列出了工具。

使用示例

"Show me the site health"
"List all my network devices"
"How many clients are connected?"
"Block client aa:bb:cc:dd:ee:ff"
"Create a new VLAN called IoT on VLAN 20 with subnet 192.168.20.1/24"
"List firewall rules"
"Run a speed test"
"Reboot the living room AP"

发展

pip install -e ".[dev]"
pytest

建筑

  • 意图tp --带有cookie jar的异步HTTP客户端（支持基于IP的源）
  • FastMCP --基于生命周期上下文的装饰器工具注册
  • Pydantic --配置验证和响应摘要
  • 直接REST --无外部UniFi库；响应汇总为每个对象10-15个字段

UDM Pro API

  • 认证： POST /api/auth/login 带有cookie会话+CSRF令牌
  • 数据： GET/POST /proxy/network/api/s/{site}/{endpoint}
  • 突变需要 X-CSRF-Token 头球
  • 401自动重新连接

相关 MCP