SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场superset-mcp

superset-mcp

智能体与模型

查看项目

更新于 10-16 07:12

技能介绍

用途

Superset MCP 服务器用于把 Superset 的编排能力接入支持 MCP 的 AI 客户端。Superset 在用户已注册的机器上，以隔离的 Git worktree 并行运行 AI 编程智能体；该 MCP 服务器（Streamable HTTP、JSON-RPC 2.0）将这套编排面完整暴露为工具，使客户端可以创建 Git worktree 工作区、启动编程智能体会话、安排自动化任务并管理任务。

服务器地址：

  • https://api.superset.sh/api/v2/agent/mcp
  • 别名：https://api.superset.sh/mcp

主要能力

工具共 27 个，分为七个系列（可调用 tools/list 获取带输入 schema 的实时目录，或访问 https://api.superset.sh/.well-known/mcp/server-card.json）：

  • hosts / projects — hosts_list、projects_list：枚举用户已注册的机器与已检出的仓库。ID 以主机为作用域，因此应从这里开始。
  • workspaces — 创建（按分支或 PR 作用域的 Git worktree）、列出、重命名、删除。
  • agents — 在工作区内以提示词启动编程智能体会话（Claude Code、Codex、OpenCode 等）；列出已安装的智能体预设。
  • terminals — 在工作区中打开 PTY，可选执行一次性命令。
  • automations — 按 RFC 5545 RRULE 安排周期性智能体运行；暂停/恢复/派发；读取运行日志。
  • tasks — 创建、搜索、更新、删除任务；列出状态与组织成员。

工具带有 MCP 行为注解：读取类为 readOnlyHint，三个 *_delete 工具为 destructiveHint，调用这些删除工具前需与用户确认。

使用方式

安装配置

Claude Code：

claude mcp add superset --transport http https://api.superset.sh/api/v2/agent/mcp

OpenAI Codex：

codex mcp add superset --url https://api.superset.sh/api/v2/agent/mcp

Gemini CLI：

gemini mcp add --transport http superset https://api.superset.sh/api/v2/agent/mcp

任何支持 Streamable HTTP 的 MCP 客户端均可使用，指向上述 URL 即可。

认证

未认证请求返回 401，并带有 WWW-Authenticate: Bearer resource_metadata="https://api.superset.sh/.well-known/oauth-protected-resource"。有两种方式：

  1. OAuth 2.1（推荐） — 授权码 + PKCE，配合 RFC 7591 动态客户端注册；用户在浏览器中批准访问。多数 MCP 客户端在首次连接时会自动处理。
  2. API key — 用户在 Superset 应用中创建，智能体以 Bearer 令牌发送。

完整说明见：https://superset.sh/auth.md

典型流程

  1. hosts_list → 选择一台在线主机。
  2. projects_list（在该主机上）→ 选择一个仓库。
  3. workspaces_create，传入 branch 或 pr — 可选传入 agents，在同一次调用中于新 worktree 内启动编程智能体。
  4. 用 tasks_create / automations_create 跟踪后续工作。

学习资料

文档同样通过 MCP 以未认证方式提供，地址为 https://docs.superset.sh/mcp（docs_search + docs_read）。人类可读文档：https://docs.superset.sh/mcp-server。

适用场景

  • 需要在多台已注册机器上并行运行 AI 编程智能体，并以隔离 Git worktree 管理各自工作区。
  • 希望通过 MCP 客户端统一枚举主机、仓库、工作区、智能体与任务。
  • 需要按 RRULE 周期性调度智能体运行，并查看运行日志。
  • 需要在工作区内打开终端执行一次性命令。

限制

  • 未认证请求会被拒绝（401），必须先完成 OAuth 2.1 或 API key 认证。
  • 工具 ID 以主机为作用域，需先获取主机与项目信息。
  • 三个 *_delete 工具为破坏性操作，调用前需与用户确认。
  • 关于收费、价格、平台支持范围、效果等具体信息，资料中暂未提供。