unifi-network-mcp
活跃·★ 378·MIT·更新于 2026-05-28
★ 宝藏工具★ API 集成
一个自托管的Model Context Protocol (MCP) 服务器，将您的UniFi网络控制器转化为一套丰富的交互式工具。
UniFi Network MCP 服务器是一个自托管的Model Context Protocol (MCP) 服务器，与UniFi网络控制器集成。它将UniFi功能作为标准化工具暴露给大型语言模型和智能代理，从而实现对网络设置的智能查询、分析和授权修改。
#UniFi 网络#MCP 服务器#LLM 工具#网络自动化#Python#Docker#API 集成#工具调用
01
功能特性
01涵盖UniFi控制器所有操作的完整目录，包括防火墙、流量路由、无线局域网和设备。
02安全优先设计：所有修改型工具都需要明确的'confirm=true'才能更改网络配置。
03灵活通信：支持标准输入输出（FastMCP）和可选的HTTP端点，以适应不同的部署环境。
04高级功能：支持代码执行模式，包含动态工具索引和异步操作，以实现高效的LLM交互。
05支持工作流自动化，允许通过环境变量跳过确认提示。
02
兼容性
Python
运行时
已通过文档验证
Docker
容器化
已通过文档验证
Model Context Protocol (MCP)
集成标准
已通过文档验证
UniFi Network Controller
目标平台
已通过文档验证
03
快速开始
1
$ git clone https://github.com/sirkirby/unifi-network-mcp.git
2
$ cd unifi-network-mcp
3
$ uv venv
4
$ source .venv/bin/activate
5
$ uv pip install --no-deps -e .
04
使用场景
↳查询和分析实时UniFi网络数据，例如客户端活动、设备状态和网络健康状况。
↳通过自然语言或程序化代理自动化复杂的网络配置和管理任务。
↳与本地或基于云的LLM（如Claude Desktop、LM Studio、Ollama）集成，实现智能网络控制。
↳开发自定义Python客户端，用于高级网络脚本编写和UniFi的程序化交互。
↳通过高效的代码执行模式优化LLM上下文使用并降低令牌成本。
05
同类工具
相关搜索
评论
登录后发表评论
- KKai Harris2026年5月4日
Works reliably with UniFi controller API.
- FFinley White2026年4月15日
Good for network admins who want AI assistance without full dashboard access.
- MMarlowe Johnson2026年3月10日
Covers the operations that require navigating multiple dashboard screens.
- CCameron Brown2026年3月4日
UniFi network management through natural language — port configs, VLANs, client management.