mcpField
S
superset-mcp

superset-mcp

github.com/paradevaiAgent 工作流7130 次安装13 周前更新
代码仓库

关于 superset-mcp

Superset MCP 通过工具协调已注册机器上的编码 Agent 与隔离的 Git 工作树，面向需要管理工作区、终端、自动化和任务的 MCP 客户端。

主要功能

  1. 01列出已注册机器和项目
  2. 02创建并管理 Git 工作区
  3. 03启动编码 Agent 会话
  4. 04打开工作区终端
  5. 05安排定期 Agent 运行
  6. 06管理组织任务

适用场景

  1. 01在分支工作树中启动编码 Agent
  2. 02安排定期 Agent 任务并查看日志
  3. 03通过组织任务跟踪编码工作

MCP 相关

MCP 服务通过 Streamable HTTP 提供 Superset 编排工具。MCP 客户端可使用 OAuth 2.1 或 Bearer API 密钥连接。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/paradevai/skills --skill superset-mcp

安装后在 Claude Code 中输入/superset-mcp确认已加载。

详细介绍

Superset MCP 服务

Superset 会在用户已注册的机器上的隔离 Git 工作树中并行运行 AI 编码 Agent。其 MCP 服务（Streamable HTTP，JSON-RPC 2.0）通过工具提供完整的编排功能。

https://api.superset.sh/api/v2/agent/mcp   (alias: https://api.superset.sh/mcp)

设置

# 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 密钥 — 用户在 Superset 应用中创建密钥，Agent 将其作为 Bearer 令牌发送。

完整指南：https://superset.sh/auth.md

工具

七个类别中共有 27 个工具（调用 tools/list 可查看包含输入架构的实时目录，也可获取 https://api.superset.sh/.well-known/mcp/server-card.json）：

  • 主机 / 项目 — hosts_list、projects_list：列出用户已注册的机器和已检出的代码库。ID 的作用范围限于主机，因此请从这里开始。
  • 工作区 — 创建（按分支或 PR 范围创建 Git 工作树）、列出、重命名、删除。
  • Agent — 在工作区中通过提示词启动编码 Agent 会话（Claude Code、Codex、OpenCode 等）；列出已安装的 Agent 预设。
  • 终端 — 在工作区中打开 PTY，可选择运行一次性命令。
  • 自动化 — 安排周期性 Agent 运行（RFC 5545 RRULE）、暂停 / 恢复 / 触发运行，并读取运行日志。
  • 任务 — 创建、搜索、更新和删除任务；列出状态和组织成员。

工具带有 MCP 行为注解：读取操作标记为 readOnlyHint，三个 *_delete 工具标记为 destructiveHint — 调用前请先向用户确认。

典型流程

  1. hosts_list → 选择一台在线主机。
  2. projects_list（在该主机上）→ 选择一个代码库。
  3. 使用 branch 或 pr 调用 workspaces_create — 还可选择传入 agents，在同一次调用中新工作树中启动编码 Agent。
  4. 使用 tasks_create / automations_create 跟踪后续工作。

了解更多

文档也通过 MCP 提供，无需身份验证，地址为 https://docs.superset.sh/mcp（docs_search + docs_read）。面向用户的文档：https://docs.superset.sh/mcp-server。

评论

支持 Markdown