首页/MCP Server 目录/enuno/unifi-mcp-server

enuno/unifi-mcp-server

❌ 实测失败serverPythonApache-2.0★ 347

An MCP server that leverages official UniFi API

实测结果

失败

沙箱内启动/握手失败，下方给出失败阶段与原始报错。失败阶段：initialize，错误类型：runtime_error。这类信息对判断“是不是我这边的环境问题”很有用，原始报错见下。

error_type: runtime_error

}, false);
        ^

UniFiMCPError [ConfigurationError]: Failed to build configuration: Required environment variable UNIFI_GATEWAY_IP is not set
    at new ConfigurationError (file:///work/node_modules/@thelord/unifi-mcp-server/dist/utils/errors.js:120:9)
    at ConfigurationBuilder.build (file:///work/node_modules/@thelord/unifi-mcp-server/dist/config/environment.js:139:19)
    at file:///work/node_modules/@thelord/unifi-mcp-server/dist/config/environment.js:421:37
    at ModuleJob.run (node:internal/modules/esm/module_job:343:25)
    at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:681:26)
    at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:117:5) {
  code: 'CONFIG_ERROR',
  statusCode: 500,
  details: { configField: 'build_error' },
  retryable: false,
  timestamp: 2026-11-11T09:16:35.911Z,
  context: undefined
}

Node.js v22.23.4

安装方式: npx
包名: @thelord/unifi-mcp-server
解析依据: npm registry match (has bin)
沙箱: docker
总耗时: 38772 ms
安装耗时: 36524 ms
工作目录: 37 MB
探针版本: 1.0.0
实测时间: 2026-11-11 17:16:36

如何使用

❌ 实测失败runtime_error · }, false)；下面配置仅供参考，跑不跑得通取决于你的环境

1安装 / 启动命令npm / npx

npx -y @thelord/unifi-mcp-server

2客户端配置Claude Desktop / Cursor

{
  "mcpServers": {
    "enuno-unifi-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@thelord/unifi-mcp-server"
      ]
    }
  }
}

整段粘进 claude_desktop_config.json 的 mcpServers 里（Cursor 用 ~/.cursor/mcp.json），保存后重启客户端。

安装方式来源：npm registry match (has bin)，沙箱实测未通过。

打开 GitHub 仓库 ↗MCP 体检工具

仓库信息

全名: enuno/unifi-mcp-server
分类: server
Stars: 347
Forks: 65
主要语言: Python
License: Apache-2.0
最近推送: 2026-11-10
仓库创建: 2025-10-18
首次收录: 2026-11-10
最近抓取: 2026-11-10