obot-admin-mcp

一个 MCP 服务器，允许 MCP 客户端（claude.ai、Claude Desktop 等）通过 REST API 管理自托管的 obot MCP 网关。使用它可以在聊天客户端内安装、列出、检查和移除 obot 中的 MCP 服务器。

为什么使用它

obot 将每个已注册的 MCP 服务器暴露为 https://<obot-host>/mcp-connect/<id>。要安装新的 MCP 服务器，通常需要调用 obot 的 REST API 或使用其管理 UI。此包将相关端点封装为 MCP 工具，因此一旦你在 obot 中注册了 obot-admin-mcp 并将其 connectURL 接入 claude.ai，你就可以要求 Claude “安装 n8n MCP” 或 “列出 obot 中的所有内容”，它就能直接工作。

工具

• list_mcp_servers — id、名称、运行时、配置状态、connectURL。

• get_mcp_server(id) — 完整清单、环境变量、缺失的必需变量。

• add_npx_mcp(name, package, env?, sensitiveKeys?, shortDescription?, alias?) — 安装 npm 发布的 stdio MCP。

• add_remote_mcp(name, url, shortDescription?, alias?) — 注册远程 HTTP/SSE MCP。

• delete_mcp_server(id) — 从 obot 中移除 MCP。

• list_catalog_entries(search?) — 浏览 obot 的目录（默认 81 个条目）。

配置

两个环境变量：

本地运行（Claude Desktop / 开发）

直接从本仓库安装（无需发布 npm — 已提交构建好的 dist/）：

{
  "mcpServers": {
    "obot-admin": {
      "command": "npx",
      "args": ["-y", "github:kiarashedraki/obot-admin-mcp"],
      "env": {
        "OBOT_URL": "https://obot.edraki.me",
        "OBOT_TOKEN": "<your-token>"
      }
    }
  }
}

在 obot 内部注册（元循环）

curl -X POST https://obot.edraki.me/api/mcp-servers \
  -H "Authorization: Bearer $OBOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "manifest": {
      "name": "obot-admin",
      "shortDescription": "Manage obot itself",
      "runtime": "npx",
      "npxConfig": { "package": "obot-admin-mcp" },
      "env": [
        { "key": "OBOT_URL",   "value": "https://obot.edraki.me", "required": true,  "sensitive": false },
        { "key": "OBOT_TOKEN", "value": "<token>",                "required": true,  "sensitive": true  }
      ]
    },
    "alias": "obot-admin"
  }'

响应包含 connectURL — 将其粘贴到 claude.ai → 设置 → 连接器 → 添加自定义连接器。

安全性

引导/管理员令牌拥有 obot 的完全控制权，该控制权会挂载主机 docker 套接字。请将此令牌视为 root 凭据。在没有额外身份验证屏障（例如在 obot-connect/<id> 前面使用 Cloudflare Access）的情况下，请勿在共享/多租户 obot 上注册 obot-admin-mcp。

许可证

MIT