MCP Server UniFi

Name: MCP Server UniFi
Author: zcking

本地服务

github.com/zcking云与基础设施1082 周前更新

代码仓库

关于 MCP Server UniFi

MCP Server UniFi 通过 UniFi Network API 将 AI Agent 接入 UniFi Network 应用。用户可用自然语言查询站点和设备，并通过 API 密钥进行身份验证。

主要功能

01查询 UniFi 站点和设备
02连接本地 UniFi Network 应用
03支持 Goose 和 Claude Desktop
04使用 API 密钥验证

适用场景

01向 AI Agent 查询 UniFi 站点信息
02用自然语言检查网络设备

MCP 相关

它向 Goose 和 Claude Desktop 等 MCP 客户端提供查询 UniFi 站点与设备的 API 操作。

#mcp-server-unifi #network-management #ai-integration

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

MCP Server UniFi

用于通过 MCP（管理控制协议）管理和控制 UniFi 网络设备的服务实现。此服务通过封装 UniFi Network API，让你能够使用 Goose 和 Claude 等 AI Agent 通过自然语言与 UniFi 网络交互。

功能

通过 AI Agent 使用自然语言查询 UniFi 站点和设备
连接到 UniFi Network 应用程序的本地服务实现
兼容 Goose AI 和 Claude Desktop
基于 API 密钥的安全身份验证

先决条件

Python 3.8 或更高版本
uv 包管理器
UniFi Network 应用程序
UniFi API 密钥（从 UniFi 控制台获取）

设置

创建 API 密钥：
- 前往 UniFi 控制台：https://unifi.ui.com
- 导航至 Settings » Control Plane » Integrations
- 点击「Create API Key」
克隆并设置代码库：

git clone https://github.com/zcking/mcp-server-unifi
cd mcp-server-unifi
uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows

安装依赖项：

uv sync

配置环境变量：

export UNIFI_API_KEY="your_api_key_here"

运行服务

启动 MCP 开发服务：

uv run mcp dev main.py

MCP Inspector 将在 http://localhost:5173 上提供，可用于测试和调试。

AI Agent 集成

Goose AI 设置

打开 Goose，前往 Settings » Extensions » Add custom extension
配置扩展：
- ID：unifi
- 名称：unifi
- 描述：获取 UniFi 网络信息
- 命令：/Users/username/.local/bin/uv --directory /path/to/mcp-server-unifi run main.py
- 环境变量：将 UNIFI_API_KEY 设置为你的 API 密钥

Claude Desktop 设置

打开 Claude，前往 Settings » Developer » Edit Config
将以下内容添加到你的 claude_desktop_config.json：

{
    "mcpServers": {
        "unifi": {
            "command": "/Users/username/.local/bin/uv",
            "args": [
                "--directory",
                "/path/to/mcp-server-unifi",
                "run",
                "main.py"
            ]
        }
    }
}

支持 Markdown

登录后评论