mcpField
S
superset-mcp

superset-mcp

github.com/superset-shエージェントワークフロー7128 回インストール13 週間前に更新
リポジトリ

superset-mcp について

superset-mcpは、登録済みマシン上の分離されたGit worktreeで並列コーディングエージェントを管理するMCPスキルです。ワークスペース、エージェントセッション、ターミナル、タスク、定期実行を扱います。

主な機能

  1. 01ホストとプロジェクトの管理
  2. 02Git worktreeの作成と管理
  3. 03コーディングエージェントの起動
  4. 04ワークスペースのターミナル操作
  5. 05エージェントの定期実行
  6. 06タスクと実行ログの追跡

活用シーン

  1. 01ブランチまたはPR用worktreeでエージェントを起動
  2. 02プロジェクトのワークスペースでコマンドを実行
  3. 03エージェントの定期作業を設定
  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 コーディングエージェントを並行して実行します。その 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 を指定してください。

認証

認証されていないリクエストには、WWW-Authenticate: Bearer resource_metadata="https://api.superset.sh/.well-known/oauth-protected-resource" とともに 401 が返されます。選択肢は次の 2 つです。

  1. OAuth 2.1（推奨） — RFC 7591 の動的クライアント登録を使った、認可コードと PKCE による認証です。ユーザーはブラウザーでアクセスを承認します。ほとんどの MCP クライアントでは、初回接続時にこの処理が自動で行われます。
  2. API キー — ユーザーが Superset アプリで API キーを作成し、エージェントが Bearer トークンとして送信します。

詳しい手順：https://superset.sh/auth.md

ツール

7 つのファミリーにわたる 27 個のツールがあります（入力スキーマを含む最新のカタログは tools/list を呼び出すか、https://api.superset.sh/.well-known/mcp/server-card.json を取得してください）。

  • hosts / projects — hosts_list、projects_list：ユーザーが登録したマシンとチェックアウト済みのリポジトリを一覧表示します。ID はホストごとに管理されるため、まずここから始めてください。
  • workspaces — ワークスペースの作成（ブランチまたは PR に対応する Git ワークツリー）、一覧表示、名前の変更、削除を行います。
  • agents — ワークスペース内でプロンプトを指定してコーディングエージェントのセッション（Claude Code、Codex、OpenCode など）を起動し、インストール済みのエージェントプリセットを一覧表示します。
  • terminals — ワークスペース内で PTY を開き、必要に応じて単発コマンドを実行します。
  • automations — エージェントの定期実行（RFC 5545 RRULE）をスケジュールし、一時停止／再開／実行を指示して、実行ログを読み取ります。
  • tasks — タスクの作成、検索、更新、削除を行い、ステータスと組織のメンバーを一覧表示します。

ツールには MCP の動作アノテーションが付いています。読み取り操作には readOnlyHint、3 つの *_delete ツールには destructiveHint が付いているため、呼び出す前にユーザーに確認してください。

典型的なフロー

  1. hosts_list → オンラインのホストを選びます。
  2. そのホストで projects_list → リポジトリを選びます。
  3. branch または pr を指定して workspaces_create を呼び出します。必要に応じて agents を渡すと、同じ呼び出しで新しいワークツリー内にコーディングエージェントを起動できます。
  4. tasks_create／automations_create で後続の作業を追跡します。

ドキュメントの参照

ドキュメントは認証なしで MCP 経由でも提供されており、https://docs.superset.sh/mcp から利用できます（docs_search ＋ docs_read）。人間向けのドキュメント：https://docs.superset.sh/mcp-server

コメント

Markdown 対応