mcpField
S
superset-mcp

superset-mcp

github.com/superset-shAgent 工作流7128 次安装13 周前更新
代码仓库

关于 superset-mcp

superset-mcp 是用于在已注册设备的隔离 Git worktree 中编排并行编码 Agent 的 MCP 技能，涵盖工作区、Agent 会话、终端、任务和定时自动化。

主要功能

  1. 01管理主机和项目
  2. 02创建和管理 Git worktree
  3. 03启动编码 Agent 会话
  4. 04打开工作区终端
  5. 05安排 Agent 自动化任务
  6. 06跟踪任务和运行日志

适用场景

  1. 01在分支或 PR worktree 中启动 Agent
  2. 02在项目工作区运行命令
  3. 03安排周期性 Agent 工作
  4. 04将后续工作记录为任务

MCP 相关

它通过 Streamable HTTP MCP 服务开放 Superset 编排工具。MCP 客户端还可通过无需认证的文档端点搜索和读取文档。

安装

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

$npx skills add https://github.com/superset-sh/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