mcpField
S
superset-mcp

superset-mcp

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

superset-mcp について

Superset MCPは、登録済みマシン上のコーディングエージェントと分離されたGitワークツリーを調整するツールを提供します。ワークスペース、ターミナル、自動化、タスクを管理するMCPクライアント向けです。

主な機能

  1. 01登録済みマシンとプロジェクトの一覧
  2. 02Gitワークスペースの作成と管理
  3. 03コーディングエージェントのセッション起動
  4. 04ワークスペースのターミナル起動
  5. 05エージェント実行の定期スケジュール
  6. 06組織タスクの管理

活用シーン

  1. 01ブランチ用ワークツリーでコーディングエージェントを起動
  2. 02定期的なエージェント実行とログ確認
  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 コーディングエージェントを並行して実行します。その 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 対応