sub-agents-mcp

Sub-Agents MCP Server

MCP 対応クライアントから、再利用可能なコーディングエージェントを実行できます。

Markdown でレビュー担当者、テスト作成者、調査担当者を作成し、アシスタントに利用を依頼します。MCP サーバーは、選択したコーディング CLI でそのエージェントを実行し、結果を同じ会話に返します。

できること

• コードレビュー、テスト作成、調査、ドキュメント作成を、専門のエージェントに委任できます
• 共有バックエンドとモデル設定を使って、同じエージェント定義を複数の MCP クライアントで再利用できます
• 複数回の呼び出しにわたって同じエージェントを継続利用し、長時間の作業を進められます

クイックスタート

Node.js 22 以降、MCP 対応クライアント、およびサポート対象のコーディング CLI がインストールされ、サインイン済みであることが必要です。この例では Codex を使用します。

1. エージェントを作成する

マシン上の任意の場所に agents フォルダーを作成し、code-reviewer.md を追加します。

# Code Reviewer

Review code for bugs and maintainability issues.

## Task

- Find concrete problems in the requested changes
- Explain why each problem matters
- Point to the affected code

## Done When

- All requested files have been reviewed
- Findings include evidence and suggested next steps

ファイル名がエージェント名になります。code-reviewer.md は code-reviewer になります。

2. MCP サーバーを追加する

クライアントの MCP 設定にサーバーを追加します。AGENTS_DIR を作成したフォルダーの絶対パスに置き換えてください。

{
  "mcpServers": {
    "sub-agents": {
      "command": "npx",
      "args": ["-y", "sub-agents-mcp"],
      "env": {
        "AGENTS_DIR": "/absolute/path/to/agents",
        "AGENT_TYPE": "codex"
      }
    }
  }
}

設定を保存した後、MCP クライアントを再起動するか、再接続してください。

3. エージェントを実行する

アシスタントに次のように依頼します。

Use the code-reviewer agent to review the authentication changes.

アシスタントが Codex でエージェントを実行し、レビュー結果を会話に返します。

使用例

Use the test-writer agent to add unit tests for the auth module.

Use the bug-investigator agent to find the cause of the failed checkout requests.

Use the doc-writer agent to document the public API changes.

エージェントと、実行してほしい作業の両方を指定してください。

MCP サーバーが適している場合

バックエンドとモデルの設定を一元管理しながら、複数の MCP クライアントで同じエージェントを共有したい場合は、MCP サーバーを使用してください。

より軽量なインストールを希望する場合や、エージェントごとにバックエンドとモデルを選択したい場合は、Sub-Agents Skills をご覧ください。

サポート対象のバックエンド

すでに使用しているバックエンドを AGENT_TYPE に設定します。

AGENT_TYPE	バックエンド	コマンド
codex	Codex	codex
claude	Claude Code	claude
cursor	Cursor CLI	cursor-agent
command-code	Command Code	command-code
glm	GLM (Z.ai)	claude
kimi	Kimi	claude
grok	Grok Build	grok
antigravity	Google Antigravity	agy 1.1.12+
gemini	Gemini CLI（互換性）	gemini
opencode	OpenCode	opencode
mcode	MiniMax Code	mcode
pi	Pi	pi

MCP サーバーの起動前に、選択した CLI をインストールして設定しておく必要があります。

GLM と Kimi には、MCP サーバーの環境で CLI_API_KEY が必要です。その他のバックエンドでは、CLI の既存の認証情報が使用されます。

Google モデルでは、Antigravity の使用を推奨します。既存のエンタープライズ、API キー、または Vertex AI の設定では、Gemini CLI も引き続き利用できます。

エージェント共通の設定

すべてのエージェントで同じモデルを使うには、AGENT_MODEL を設定します。設定しない場合は、バックエンドのデフォルトが使われます。

AGENT_PERMISSION でエージェントに許可する操作を制御します。

• read-only — レビューと調査
• safe-edit — 承認なしで編集可能（デフォルト）
• yolo — 制限なしで実行

操作がブロックされたとエージェントが報告した場合は、より制限の少ないモードを選択してください。

各レベルがどの程度厳密に適用されるかはバックエンドによって異なるため、セキュリティ境界ではなく目安として扱ってください。

複数回の呼び出しにわたって作業を続ける

エージェントに以前の呼び出しを記憶させ、より長いタスクを継続させる場合は、SESSION_ENABLED を "true" に設定します。セッションを続けるには、次の呼び出しでアシスタントが返された session_id を再利用する必要があります。

起動しない場合

• 選択したバックエンドのコマンドを直接実行し、インストール済みでサインイン済みであることを確認します
• AGENTS_DIR が絶対パスであり、少なくとも 1 つの .md または .txt ファイルを含んでいることを確認します
• 設定を変更した後、MCP クライアントを再起動するか、再接続します

ライセンス

MIT