Skip to main content
Glama
multi-agent-mcp

multi-agent-mcp

by shiiman

Multi-Agent MCP

AI CLI(Claude Code / Codex / Antigravity (agy) / Cursor)+ tmux + git worktree (または非gitディレクトリ)を使用したマルチエージェントワークフローの MCP サーバー。

概要

このMCPサーバーは、複数のAI CLIインスタンスを tmux セッションで管理し、並列作業を実現します。 MCP_ENABLE_GIT=false を設定すると、git 管理されていないディレクトリでも実行できます。

Gitモード

モード

設定

挙動

Git有効(デフォルト)

MCP_ENABLE_GIT=true

git リポジトリ前提。worktree/gtr 機能を利用可能

Git無効

MCP_ENABLE_GIT=false

非gitディレクトリで実行可能。git/worktree/gtr 機能は無効

init_tmux_workspace(enable_git=...) を指定すると、.multi-agent-mcp/config.json に保存され、 以降の同一プロジェクト実行で参照されます。

階層構造

  • Owner (1体): 全体指揮、タスク分解、Issue作成

  • Admin (1体): Worker管理、進捗管理、ダッシュボード更新

  • Worker (標準6体 / 最大16体): 割り当てられたタスクの実行

対応 AI CLI 一覧

CLI

識別子

備考

Claude Code

claude

デフォルト構成で利用可能

Codex

codex

デフォルト構成で利用可能

Antigravity (agy)

agy

デフォルト構成で利用可能。事前に端末CLIのセットアップが必要(後述)

Cursor

cursor

既定コマンドは agent

agy(Antigravity CLI)のセットアップ

agy は Gemini CLI の後継となる Antigravity の端末 CLI 版です。利用前に以下を行ってください。

インストール

curl -fsSL https://antigravity.google/cli/install.sh | bash

デスクトップアプリとの PATH 衝突に注意

Antigravity デスクトップアプリをインストール済みの環境では、アプリ同梱の agy が PATH 上で先に解決されることがあります。端末 CLI 版を優先させるには、 インストール先(通常 ~/.local/bin)を PATH の先頭に追加するか、 シェルの rc ファイルでエイリアスを設定してください。

# 例: ~/.zshrc / ~/.bashrc
export PATH="$HOME/.local/bin:$PATH"

サインイン

引数なしで agy を起動するとサインインフローが開始されます。

agy

サインインが完了すれば、ai_cli="agy" で Admin/Worker から利用できます。

eligibility 要件

agy でエージェントを起動するには、Antigravity の利用資格を満たす Google アカウントが必要です。 一部の Google Workspace アカウントではサインインに成功しても agy --print 実行時に Eligibility check failed: ... not eligible for Antigravity のエラーで起動できないことがあります。この場合は個人の Google アカウントを使うか、 Workspace 管理者に Antigravity の利用有効化を依頼してください。

実起動確認手順(手動)

eligibility が解決したアカウントで、実際にセッションが継続することを手動確認してください (本プロジェクトのテストコードでは agy の実起動検証は行っていません)。

  1. 小規模構成(Admin + Worker 1)で ai_cli="agy" を指定してワークスペースを起動する。

  2. tmux ペイン内で agy が --prompt-interactive により起動直後の応答だけで終了せず、 セッションを継続していることを確認する。

  3. Admin/Worker 間で IPC メッセージを送信し、ペインに [IPC] 新しいメッセージ の通知が 表示され、agy がそれに反応して作業を再開することを確認する(ワンショット終了しないこと)。

Related MCP server: Claude Team MCP Server

必要条件

  • Python 3.10以上

  • tmux

  • uv(推奨)または pip

最短セットアップ

  1. MCP クライアントに multi-agent-mcp を登録します。 Claude / Codex は次の CLI 例を使い、Antigravity (agy) / Cursor などで CLI サブコマンドが異なる場合は この後の JSON 設定例と同じ command=uvx / args=[...] を登録してください。

  2. クライアントを再起動し、MCP サーバーへ再接続します。

  3. クライアント上で init_tmux_workspace("/path/to/project", session_id="issue-123") を実行して ワークスペースを初期化します。非 git ディレクトリでは enable_git=false を指定します。

インストール

GitHub から直接インストールできます(リポジトリの clone は不要)。

CLI で追加

通常運用では --reinstall なしを推奨します。 追加コマンドは次の「設定の追加・削除(再インストールとは別)」を参照してください。

設定の追加・削除(再インストールとは別)

Claude

# 追加(--reinstall なし)
claude mcp add --scope user multi-agent-mcp -- uvx --from git+https://github.com/shiiman/multi-agent-mcp multi-agent-mcp

# 削除
claude mcp remove multi-agent-mcp

Codex

# 追加(--reinstall なし)
codex mcp add multi-agent-mcp -- uvx --from git+https://github.com/shiiman/multi-agent-mcp multi-agent-mcp

# 削除
codex mcp remove multi-agent-mcp

Antigravity (agy) / Cursor など

CLI からの追加コマンドが未提供、または実装差分があるクライアントでは、 次の「設定ファイルに直接記述」の JSON 例と同じ内容を登録してください。

設定ファイルに直接記述

グローバル設定 (~/.claude.json):

{
  "mcpServers": {
    "multi-agent-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/shiiman/multi-agent-mcp",
        "multi-agent-mcp"
      ]
    }
  }
}

プロジェクト設定 (.mcp.json をプロジェクトルートに作成):

{
  "mcpServers": {
    "multi-agent-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/shiiman/multi-agent-mcp",
        "multi-agent-mcp"
      ]
    }
  }
}

自動更新について

--reinstall オプションを付けると、起動時に毎回 GitHub から最新版を再インストールします。

Note: --refresh オプションでは Git リポジトリのキャッシュが効いたままになり、更新が反映されないことがあります。確実に最新版を使用するには --reinstall を推奨します。

--reinstall なし運用で更新したい場合は、次の「必要なときだけ再インストールする手順」を実行してください。

必要なときだけ再インストールする手順(Claude/Codex 共通):

# 1) 1回だけ再インストール(通常運用では毎回不要)
uv tool install --force --from git+https://github.com/shiiman/multi-agent-mcp multi-agent-mcp

# 2) 使用中のクライアントを再起動して MCP を再接続
# - Claude を使っている場合: Claude を再起動
# - Codex を使っている場合: Codex を再起動

# 3) 反映確認(使用クライアントに応じて実行)
claude mcp list
codex mcp get multi-agent-mcp

# 4) 反映されない場合のみキャッシュクリア
uv cache clean multi-agent-mcp

上記の JSON 例は、mcpServers 形式を採用しているクライアントであれば Claude / Codex 以外でも同様の考え方で利用できます。

設定の確認

# Claude
claude mcp list

# Codex
codex mcp list

提供するTools(90個)

セッション管理(4個)

Tool

説明

init_tmux_workspace

ターミナルを開いてtmuxワークスペースを構築(Admin 1 + Worker 1-6 の7ペイン)

cleanup_workspace

全エージェントを終了しリソースを解放

check_all_tasks_completed

全タスクの完了状態をチェック

cleanup_on_completion

全タスク完了時にワークスペースをクリーンアップ

エージェント管理(6個)

Tool

説明

create_agent

新しいエージェントを作成(tmuxセッション起動)

list_agents

全エージェントの一覧を取得

get_agent_status

指定エージェントの詳細ステータスを取得

terminate_agent

エージェントを終了

initialize_agent

エージェントにロールテンプレートを渡してAI CLIを起動

create_workers_batch

複数のWorkerを並列で作成しタスクを割り当て

コマンド実行(5個)

Tool

説明

send_command

エージェントにコマンドを送信

get_output

エージェントのtmux出力を取得

send_task

タスク指示をファイル経由でWorkerに送信

open_session

エージェントのtmuxセッションをターミナルで開く

broadcast_command

全エージェント(または特定役割)にコマンド送信

Git Worktree管理(7個)

Tool

説明

create_worktree

新しいgit worktreeを作成(git有効時のみ)

list_worktrees

worktree一覧を取得(git有効時のみ)

remove_worktree

worktreeを削除(git有効時のみ)

assign_worktree

エージェントにworktreeを割り当て(git有効時のみ)

get_worktree_status

worktreeのgitステータスを取得(git有効時のみ)

check_gtr_available

gtr (git-worktree-runner) の利用可否を確認(git有効時のみ)

open_worktree_with_ai

gtr aiでworktreeをAIツールで開く(git有効時のみ)

create_worktree の引数契約

create_worktree は以下の引数契約です(branch_name 引数は存在しません)。

create_worktree(
    repo_path="/path/to/repo",
    worktree_path="/path/to/worktree",
    branch="feature/xxx",
    create_branch=True,
    base_branch="main",
    caller_agent_id="admin-or-owner-id",
)

マージ(1個)

Tool

説明

merge_completed_tasks

完了タスクの作業ブランチを commit なしで統合ブランチへ展開

IPC/メッセージング(5個)

Tool

説明

send_message

エージェント間でメッセージを送信

read_messages

エージェントのメッセージを読み取る

get_unread_count

未読メッセージ数を取得

unlock_owner_wait

Owner の待機ロックを手動解除

register_agent_to_ipc

エージェントをIPCシステムに登録

ダッシュボード/タスク管理(15個)

Tool

説明

create_task

新しいタスクを作成

reopen_task

終端タスクを再開(再実行用)

update_task_status

タスクのステータスを更新(Admin専用)

assign_task_to_agent

タスクをエージェントに割り当て(Admin専用)

list_tasks

タスク一覧を取得

report_task_progress

Workerがタスクの進捗を報告

report_task_completion

WorkerがAdminにタスク完了を報告(Worker専用)

get_task

タスクの詳細を取得

remove_task

タスクを削除

get_dashboard

ダッシュボード全体を取得

get_dashboard_summary

ダッシュボードのサマリーを取得

get_cost_estimate

現在のコスト推定を取得

set_cost_warning_threshold

コスト警告の閾値を設定

reset_cost_counter

コストカウンターをリセット

get_cost_summary

コストサマリーを取得

create_task の metadata 運用

create_task では、タスク説明文字列だけでなく metadata を渡す運用を推奨します。

  • task_kind: タスク種別(例: implementation / qa / docs / report)

  • requires_playwright: Playwright 検証が必要なタスクか(true/false)

  • output_dir: 成果物の出力先(例: .multi-agent-mcp/{session_id}/reports)

update_task_status の遷移制約

  • update_task_status は通常の前進遷移に使用します。

  • completed / failed / cancelled の終端状態になったタスクを再開するときは、 update_task_status で直接戻さず reopen_task を使用してください。

調査レポートの出力ルール

  • 調査・検証系タスクの Markdown 成果物は .multi-agent-mcp/{session_id}/reports/*.md に出力します。

  • 出力先は create_task.metadata.output_dir で明示し、Worker 指示にも同じパスを記載します。

Gtrconfig(3個)

Tool

説明

check_gtrconfig

.gtrconfigの存在確認と内容取得

analyze_project_for_gtrconfig

プロジェクト構造を解析して推奨設定を提案

generate_gtrconfig

.gtrconfigを自動生成

テンプレート(6個)

Tool

説明

list_workspace_templates

利用可能なテンプレート一覧を取得

get_workspace_template

特定テンプレートの詳細を取得

get_role_guide

特定ロールのワークフローガイドを取得

list_role_guides

利用可能なロールガイド一覧を取得

list_report_templates

利用可能なレポートテンプレート一覧を取得

get_report_template

特定レポートテンプレートの内容を取得

スケジューラー(3個)

Tool

説明

enqueue_task

タスクをスケジューラーキューに追加

auto_assign_tasks

空いているWorkerにタスクを自動割り当て

get_task_queue

現在のタスクキューを取得

ヘルスチェック(6個)

Tool

説明

healthcheck_agent

特定エージェントのヘルスチェックを実行

healthcheck_all

全エージェントのヘルスチェックを実行

get_unhealthy_agents

異常なエージェント一覧を取得

attempt_recovery

エージェントの復旧を試みる

full_recovery

Worker を完全復旧(agent/worktree再作成+タスク再割り当て)

monitor_and_recover_workers

Worker監視と段階復旧(attempt→full→failed化)を実行

ペルソナ(3個)

Tool

説明

detect_task_type

タスクの説明からタスクタイプを検出

get_optimal_persona

タスクに最適なペルソナを取得

list_personas

利用可能なペルソナ一覧を取得

メモリ管理(19個)

Tool

説明

save_to_memory

知識をプロジェクトメモリに保存

retrieve_from_memory

プロジェクトメモリから知識を検索

get_memory_entry

キーでメモリエントリを取得

list_memory_entries

メモリエントリ一覧を取得

delete_memory_entry

メモリエントリを削除

get_memory_summary

メモリのサマリー情報を取得

search_memory_archive

アーカイブされたメモリを検索

list_memory_archive

アーカイブエントリ一覧を取得

restore_from_memory_archive

アーカイブからエントリを復元

get_memory_archive_summary

アーカイブのサマリー情報を取得

save_to_global_memory

グローバルメモリに保存(全プロジェクト共通)

retrieve_from_global_memory

グローバルメモリから検索

list_global_memory_entries

グローバルメモリエントリ一覧を取得

get_global_memory_summary

グローバルメモリのサマリーを取得

delete_global_memory_entry

グローバルメモリエントリを削除

search_global_memory_archive

グローバルアーカイブを検索

list_global_memory_archive

グローバルアーカイブ一覧を取得

restore_from_global_memory_archive

グローバルアーカイブからエントリを復元

get_global_memory_archive_summary

グローバルアーカイブのサマリーを取得

スクリーンショット(4個)

Tool

説明

get_screenshot_dir

スクリーンショットディレクトリを取得

list_screenshots

スクリーンショット一覧(最新N件)

read_screenshot

指定ファイルを読み取り(Base64)

read_latest_screenshot

最新のスクリーンショットを読み取り

モデルプロファイル(3個)

Tool

説明

get_model_profile

現在のプロファイルを取得

switch_model_profile

プロファイルを切り替え(standard/performance)

get_model_profile_settings

プロファイルの設定詳細を取得

switch_model_profile の方針

  • モデルプロファイルの正準保存先は .multi-agent-mcp/.env(MCP_MODEL_PROFILE_ACTIVE)です。

  • switch_model_profile は .env のみを更新し、config.json へは保存しません。

  • config.json はセッション設定(session_id, enable_git など)専用です。

主要フィールド(公開I/F)

Agent

  • 主要フィールド: id, role, status, tmux_session, working_dir, worktree_path, current_task

  • グリッド/CLI 関連: session_name, window_index, pane_index, ai_cli, ai_bootstrapped

Dashboard / Task

  • TaskInfo: task_file_path, metadata, started_at, completed_at, error_message

  • metadata には requested_description や運用キー(task_kind など)を保持します

  • Dashboard 運用フィールド: session_started_at, session_finished_at, process_crash_count, process_recovery_count

使用例

# ターミナルを開いてtmuxワークスペースを構築(git有効)
init_tmux_workspace("/path/to/project", session_id="issue-123")

# 非gitディレクトリで実行
init_tmux_workspace("/path/to/non-git-dir", session_id="issue-123", enable_git=false)

# Ownerエージェントを作成
create_agent(
    role="owner",
    working_dir="/path/to/project",
)

# Workerエージェントを作成
create_agent(
    role="worker",
    working_dir="/path/to/worktree1",
    caller_agent_id="admin-or-owner-id",
)
create_agent(
    role="worker",
    working_dir="/path/to/worktree2",
    caller_agent_id="admin-or-owner-id",
)

# エージェント一覧を確認
list_agents(caller_agent_id="admin-or-owner-id")

# Workerにコマンドを送信
send_command(
    agent_id="abc12345",
    command="echo 'Hello from Worker'",
    caller_agent_id="admin-or-owner-id",
)

# 出力を取得
get_output(
    agent_id="abc12345",
    lines=100,
    caller_agent_id="admin-or-owner-id",
)

# 全Workerにコマンドをブロードキャスト
broadcast_command(
    command="git status",
    role="worker",
    caller_agent_id="admin-or-owner-id",
)

# クリーンアップ
cleanup_workspace(caller_agent_id="owner-id")

ドキュメント

各システムの詳細な解説は以下を参照してください:

ドキュメント

説明

Files システム

永続ファイル/ディレクトリ構造と命名規則

IPC システム

エージェント間メッセージ通信の仕組み

Memory システム

知識の永続化・共有・アーカイブ機能

Worktree システム

Git worktree による分離作業環境

Dashboard システム

タスク状態管理とダッシュボード表示

Healthcheck システム

Worker 監視、段階復旧、daemon 運用

Merge ガイド

完了タスクブランチの統合運用

環境変数

変数

デフォルト

説明

MCP_MCP_DIR

.multi-agent-mcp

MCP設定ディレクトリ名

MCP_ENABLE_GIT

true

git 前提機能を有効化するか(falseで非gitディレクトリ許可)

MCP_ENABLE_WORKTREE

false

worktreeを使用するか(MCP_ENABLE_GIT=false の場合は無効)

MCP_ENABLE_CURSOR_IMAGE_ROUTING

false

画像タスクの Cursor ルーティングを有効化するか(既定 false)

MCP_WINDOW_NAME_MAIN

main

メインウィンドウ名(Admin + Worker 1-6)

MCP_WINDOW_NAME_WORKER_PREFIX

workers-

追加Workerウィンドウ名のプレフィックス

MCP_EXTRA_WORKER_ROWS

2

追加ウィンドウの行数

MCP_EXTRA_WORKER_COLS

5

追加ウィンドウの列数

MCP_WORKERS_PER_EXTRA_WINDOW

10

追加ウィンドウのWorker数

MCP_COST_WARNING_THRESHOLD_USD

10.0

コスト警告の閾値(USD)

MCP_ESTIMATED_TOKENS_PER_CALL

5000

1回のAPI呼び出しあたりの推定トークン数

MCP_MODEL_COST_TABLE_JSON

{"claude:opus":0.03,...}

モデル別1000トークン単価テーブル(JSON)

MCP_MODEL_COST_DEFAULT_PER_1K

0.01

未定義モデル向けの汎用単価(USD/1K)

MCP_HEALTHCHECK_INTERVAL_SECONDS

60

ヘルスチェック監視ループの実行間隔(秒)

MCP_HEALTHCHECK_STALL_TIMEOUT_SECONDS

600

無応答判定の閾値(秒)

MCP_HEALTHCHECK_IN_PROGRESS_NO_IPC_TIMEOUT_SECONDS

120

in_progress タスクの無通信判定閾値(秒)

MCP_HEALTHCHECK_MAX_RECOVERY_ATTEMPTS

3

同一worker/taskに対する復旧試行回数の上限

MCP_HEALTHCHECK_IDLE_STOP_CONSECUTIVE

3

実作業なし検知が連続したとき daemon を自動停止する閾値

MCP_CODEX_ENTER_RETRY_MAX

3

Codex への Enter 再送回数の上限

MCP_CODEX_ENTER_RETRY_INTERVAL_MS

250

Codex への Enter 再送間隔(ミリ秒)

MCP_SEND_COOLDOWN_SECONDS

2.0

tmux への連続送信時に挟む最小待機秒数

MCP_DEFAULT_TERMINAL

auto

ターミナルアプリ(auto: cmux→ghostty→iterm2→terminal)

MCP_MODEL_PROFILE_ACTIVE

standard

モデルプロファイル(standard/performance)

MCP_MODEL_PROFILE_STANDARD_CLI

codex

standardプロファイルのAI CLI

MCP_MODEL_PROFILE_STANDARD_ADMIN_MODEL

gpt-5.5

standardプロファイルのAdminモデル

MCP_MODEL_PROFILE_STANDARD_WORKER_MODEL

gpt-5.5

standardプロファイルのWorkerモデル

MCP_MODEL_PROFILE_STANDARD_MAX_WORKERS

6

standardプロファイルのWorker上限

MCP_MODEL_PROFILE_STANDARD_ADMIN_THINKING_TOKENS

4000

standardプロファイルのAdmin思考トークン数

MCP_MODEL_PROFILE_STANDARD_WORKER_THINKING_TOKENS

4000

standardプロファイルのWorker思考トークン数

MCP_MODEL_PROFILE_STANDARD_ADMIN_REASONING_EFFORT

medium

standardプロファイルのAdmin推論強度

MCP_MODEL_PROFILE_STANDARD_WORKER_REASONING_EFFORT

medium

standardプロファイルのWorker推論強度

MCP_MODEL_PROFILE_PERFORMANCE_CLI

codex

performanceプロファイルのAI CLI

MCP_MODEL_PROFILE_PERFORMANCE_ADMIN_MODEL

gpt-5.5

performanceプロファイルのAdminモデル

MCP_MODEL_PROFILE_PERFORMANCE_WORKER_MODEL

gpt-5.5

performanceプロファイルのWorkerモデル

MCP_MODEL_PROFILE_PERFORMANCE_MAX_WORKERS

16

performanceプロファイルのWorker上限

MCP_MODEL_PROFILE_PERFORMANCE_ADMIN_THINKING_TOKENS

30000

performanceプロファイルのAdmin思考トークン数

MCP_MODEL_PROFILE_PERFORMANCE_WORKER_THINKING_TOKENS

4000

performanceプロファイルのWorker思考トークン数

MCP_MODEL_PROFILE_PERFORMANCE_ADMIN_REASONING_EFFORT

high

performanceプロファイルのAdmin推論強度

MCP_MODEL_PROFILE_PERFORMANCE_WORKER_REASONING_EFFORT

high

performanceプロファイルのWorker推論強度

MCP_PROJECT_ROOT

-

プロジェクトルート(.env読み込み用)

MCP_CLI_DEFAULT_CLAUDE_ADMIN_MODEL

opus

Claude CLIのAdminデフォルトモデル

MCP_CLI_DEFAULT_CLAUDE_WORKER_MODEL

sonnet

Claude CLIのWorkerデフォルトモデル

MCP_CLI_DEFAULT_CODEX_ADMIN_MODEL

gpt-5.5

Codex CLIのAdminデフォルトモデル

MCP_CLI_DEFAULT_CODEX_WORKER_MODEL

gpt-5.5

Codex CLIのWorkerデフォルトモデル

MCP_CLI_DEFAULT_AGY_ADMIN_MODEL

gemini-3.1-pro-high

Agy CLIのAdminデフォルトモデル

MCP_CLI_DEFAULT_AGY_WORKER_MODEL

gemini-3.6-flash-medium

Agy CLIのWorkerデフォルトモデル

MCP_CLI_DEFAULT_CURSOR_ADMIN_MODEL

composer-1.5

Cursor CLIのAdminデフォルトモデル

MCP_CLI_DEFAULT_CURSOR_WORKER_MODEL

composer-1.5

Cursor CLIのWorkerデフォルトモデル

MCP_WORKER_CLI_MODE

uniform

Worker CLI設定モード(uniform/per-worker)

MCP_WORKER_CLI_1..16

(empty)

per-workerモードでのWorker別CLI設定(未設定時はアクティブプロファイルCLIを利用)

MCP_WORKER_MODEL_1..16

(empty)

per-workerモードでのWorker別モデル設定(未設定時はプロファイルのWORKER_MODEL)

MCP_QUALITY_CHECK_MAX_ITERATIONS

3

品質チェックの最大イテレーション回数

MCP_QUALITY_CHECK_SAME_ISSUE_LIMIT

3

同一問題の繰り返し上限

MCP_QUALITY_GATE_STRICT

true

品質ゲートを厳格に適用するか

MCP_MEMORY_MAX_ENTRIES

1000

メモリの最大エントリ数

MCP_MEMORY_TTL_DAYS

90

メモリエントリの保持期間(日)

MCP_SCREENSHOT_EXTENSIONS

[".png",".jpg",...]

スクリーンショットとして認識する拡張子

Worker上限は MCP_MODEL_PROFILE_ACTIVE に応じて MCP_MODEL_PROFILE_STANDARD_MAX_WORKERS / MCP_MODEL_PROFILE_PERFORMANCE_MAX_WORKERS のどちらかが適用されます。

MCP_MODEL_COST_TABLE_JSON の agy 分は agy models の実 ID(tier 内包、例 gemini-3.1-pro-high / gemini-3.6-flash-medium)で構成しています。1K トークン単価は暫定見積りのため、 agy の公式単価が公開され次第、要更新です。

ディレクトリ構造

init_tmux_workspace 実行時に以下のディレクトリと .env ファイルが自動作成されます:

{project_root}/.multi-agent-mcp/
├── .env                    # プロジェクト設定(テンプレート付き)
├── config.json             # 実行時設定(session_id / enable_git など)
├── memory/                 # プロジェクトメモリ
├── screenshot/             # スクリーンショット保存先
└── {YYYYMMDD}-{HHMMSS}-{session_id}/  # セッション別(時系列プレフィックス)
    ├── dashboard/          # ダッシュボード
    ├── tasks/              # タスクファイル
    └── reports/            # 調査/検証レポート(*.md)

プロジェクト別設定

プロジェクトごとに設定を変更する場合、.multi-agent-mcp/.env ファイルを編集してください。 init_tmux_workspace 実行時に、設定可能な全変数がコメント付きで自動生成されます。

設定の優先順位:

  1. 環境変数(最優先)

  2. .multi-agent-mcp/.env ファイル

  3. デフォルト値

enable_git のみ、実行時は以下の優先順位で解決されます:

  1. init_tmux_workspace(enable_git=...) の引数

  2. .multi-agent-mcp/config.json の enable_git

  3. 環境変数 / .env

  4. デフォルト値(true)

gitignore 推奨

タスクファイルやダッシュボードは .multi-agent-mcp/ ディレクトリに出力されます。 このディレクトリは一時ファイルなので、.gitignore に追加することを推奨します。

# プロジェクトの .gitignore に追加
echo ".multi-agent-mcp/" >> .gitignore

開発(コントリビューター向け)

ローカルで開発する場合は、リポジトリをクローンしてください。

# リポジトリをクローン
git clone https://github.com/shiiman/multi-agent-mcp.git
cd multi-agent-mcp

# 開発用依存関係をインストール
uv sync --all-extras

# テストを実行
uv run pytest

# 高速反復(キーワードで対象テストのみ)
uv run pytest -k healthcheck

# 高速反復(ファイル単位)
uv run pytest tests/test_healthcheck_manager.py

# リンターを実行
uv run ruff check src/

トラブルシューティング

tmux セッションが見つからない

エラー: tmux セッションが見つかりません

原因: tmux がインストールされていないか、ワークスペースが初期化されていません。

対処法:

  1. tmux -V で tmux のインストールを確認

  2. init_tmux_workspace でワークスペースを初期化

Worker が応答しない(stall 検出)

原因: AI CLI プロセスがハングアップしている可能性があります。

対処法:

  1. healthcheck_agent で状態を確認

  2. attempt_recovery で軽量復旧を試行

  3. それでも改善しない場合は full_recovery で完全復旧

dashboard.md が読み込めない

原因: YAML Front Matter のフォーマットが壊れている可能性があります。

対処法:

  1. .multi-agent-mcp/{session_id}/dashboard/dashboard.md を削除

  2. get_dashboard を実行すると自動で再生成されます

MCP サーバーが起動しない

原因: 依存パッケージのバージョン不整合の可能性があります。

対処法:

# キャッシュクリア + 再インストール
uv cache clean multi-agent-mcp
uv tool install --force --from git+https://github.com/shiiman/multi-agent-mcp multi-agent-mcp

ライセンス

MIT

Available Tools

90 tools
analyze_project_for_gtrconfigC

プロジェクト構造を解析して推奨設定を提案する。

※ Owner と Admin のみ使用可能。

Args: project_path: プロジェクトのルートパス caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 推奨設定(success, recommended_config)

Inputs: project_path (required), caller_agent_id. Returns: object

assign_task_to_agentB

タスクをエージェントに割り当てる。

※ Admin のみ使用可能。

Args: task_id: タスクID agent_id: エージェントID branch: 作業ブランチ(オプション) worktree_path: worktreeパス(オプション) caller_agent_id: 呼び出し元エージェントID(ロールチェック用)

Returns: 割り当て結果(success, task_id, agent_id, message または error)

Inputs: task_id (required), agent_id (required), branch, worktree_path, +1 more. Returns: object

assign_worktreeB

エージェントにworktreeを割り当てる。

※ Owner と Admin のみ使用可能。

Args: agent_id: エージェントID worktree_path: worktreeのパス branch: ブランチ名 caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 割り当て結果(success, agent_id, worktree_path, message または error)

Inputs: branch (required), agent_id (required), worktree_path (required), caller_agent_id. Returns: object

attempt_recoveryC

エージェントの復旧を試みる。

※ Owner と Admin のみ使用可能。

Args: agent_id: エージェントID caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 復旧結果(success, message)

Inputs: agent_id (required), caller_agent_id. Returns: object

auto_assign_tasksA

空いているWorkerにタスクを自動割り当てする。

※ Admin のみ使用可能。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 割り当て結果(success, assignments, count)

Inputs: caller_agent_id. Returns: object

broadcast_commandA

全エージェント(または特定役割)にコマンドをブロードキャストする。

※ Owner と Admin のみ使用可能。

Args: command: 実行するコマンド role: 対象の役割(省略時は全員、有効: owner/admin/worker) allow_dangerous: 危険判定コマンドを明示許可するか caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 送信結果(success, command, role_filter, results, summary または error)

Inputs: command (required), role, allow_dangerous, caller_agent_id. Returns: object

check_all_tasks_completedA

全タスクが完了したかチェックする。

完了条件: pending=0, in_progress=0, failed=0 failedタスクがある場合は完了と見なさない。

※ Owner のみ使用可能。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: is_all_completed: 全タスク完了か total_tasks: 総タスク数 pending_tasks: 未着手タスク数 in_progress_tasks: 進行中タスク数 completed_tasks: 完了タスク数 failed_tasks: 失敗タスク数

Inputs: caller_agent_id. Returns: object

check_gtr_availableC

gtr (git-worktree-runner) が利用可能か確認する。

※ Owner と Admin のみ使用可能。

Args: repo_path: リポジトリのパス caller_agent_id: 呼び出し元エージェントID(必須)

Returns: gtrの利用可否(success, gtr_available, message)

Inputs: repo_path (required), caller_agent_id. Returns: object

check_gtrconfigB

Gtrconfigの存在確認と内容取得。

※ Owner と Admin のみ使用可能。

Args: project_path: プロジェクトのルートパス caller_agent_id: 呼び出し元エージェントID(必須)

Returns: Gtrconfig状態(success, status)

Inputs: project_path (required), caller_agent_id. Returns: object

cleanup_on_completionA

全タスク完了時にワークスペースをクリーンアップする。

タスクが完了していない場合はエラーを返す。 force=True で未完了でも強制クリーンアップ。

※ Owner のみ使用可能。

Args: force: 未完了でも強制的にクリーンアップするか repo_path: メインリポジトリのパス(worktree 削除に使用) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: クリーンアップ結果

Inputs: force, repo_path, caller_agent_id. Returns: object

cleanup_workspaceA

ワークスペースをクリーンアップする。

全エージェントを終了し、リソースを解放する。

※ Owner のみ使用可能。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: クリーンアップ結果(success, terminated_sessions, cleared_agents, message)

Inputs: caller_agent_id. Returns: object

create_agentB

新しいエージェントを作成する。

単一セッション方式: 左右40:60分離レイアウト

  • Owner: tmux ペインに配置しない(実行AIエージェントが担う)

  • 左 40%: Admin (pane 0)

  • 右 60%: Worker 1-6 (pane 1-6)

  • Worker 7以降は追加ウィンドウ(2×5=10ペイン/ウィンドウ)

※ Owner と Admin のみ使用可能。

Args: role: エージェントの役割(owner/admin/worker) working_dir: 作業ディレクトリのパス ai_cli: 使用するAI CLI(claude/codex/agy/cursor、省略でデフォルト) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 作成結果(success, agent, message または error)

Inputs: role (required), working_dir (required), ai_cli, caller_agent_id. Returns: object

create_taskB

新しいタスクを作成する。

※ Owner と Admin のみ使用可能。

Args: title: タスクタイトル description: タスク説明 assigned_agent_id: 割り当て先エージェントID(オプション) branch: 作業ブランチ(オプション) metadata: 追加メタデータ(オプション) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 作成結果(success, task, message または error)

Inputs: title (required), branch, metadata, description, +2 more. Returns: object

create_workers_batchC

複数 Worker を並列作成し、タスク割り当て・送信も実行する。※ Owner/Admin のみ。

Inputs: repo_path (required), base_branch (required), worker_configs (required), session_id, +2 more. Returns: object

create_worktreeA

新しいgit worktreeを作成する。

※ Owner と Admin のみ使用可能。

Args: repo_path: メインリポジトリのパス worktree_path: 作成するworktreeのパス branch: ブランチ名 create_branch: 新しいブランチを作成するか(デフォルト: True) base_branch: 基点ブランチ(create_branch=Trueの場合のみ有効) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 作成結果(success, worktree_path, branch, message または error)

Inputs: branch (required), repo_path (required), worktree_path (required), base_branch, +2 more. Returns: object

delete_global_memory_entryA

グローバルメモリエントリを削除する(全プロジェクト共通)。

※ Owner と Admin のみ使用可能。

Args: key: 削除するエントリのキー caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 削除結果(success, key, message)

Inputs: key (required), caller_agent_id. Returns: object

delete_memory_entryC

メモリエントリを削除する。

※ Owner と Admin のみ使用可能。

Args: key: 削除するエントリのキー caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 削除結果(success, key, message)

Inputs: key (required), caller_agent_id. Returns: object

detect_task_typeC

タスクの説明からタスクタイプを検出する。

※ Admin のみ使用可能。

Args: task_description: タスクの説明文 caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 検出結果(success, task_type, persona)

Inputs: task_description (required), caller_agent_id. Returns: object

enqueue_taskB

タスクをスケジューラーキューに追加する。

※ Admin のみ使用可能。

Args: task_id: タスクID priority: 優先度(critical/high/medium/low) dependencies: 依存タスクのIDリスト caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 追加結果(success, task_id, priority, message または error)

Inputs: task_id (required), priority, dependencies, caller_agent_id. Returns: object

full_recoveryA

異常なエージェントの完全復旧を実行する。

以下のステップで復旧を行う:

  1. 古い agent を terminate

  2. 古い worktree を remove(存在する場合)

  3. 新しい worktree を作成(同じブランチ名で)

  4. 新しい agent を作成

  5. 未完了のタスクを新しい agent に再割り当て

※ Admin のみ使用可能。

Args: agent_id: 復旧対象のエージェントID caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 復旧結果(success, old_agent_id, new_agent_id, reassigned_tasks, message)

Inputs: agent_id (required), caller_agent_id. Returns: object

generate_gtrconfigC

Gtrconfigを自動生成する。

※ Owner のみ使用可能。

Args: project_path: プロジェクトのルートパス overwrite: 既存ファイルを上書きするか caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 生成結果(success, config, message または error)

Inputs: project_path (required), overwrite, caller_agent_id. Returns: object

get_agent_statusB

指定エージェントの詳細ステータスを取得する。

Args: agent_id: エージェントID caller_agent_id: 呼び出し元エージェントID(必須)

Returns: エージェント詳細(success, agent, session_active または error)

Inputs: agent_id (required), caller_agent_id. Returns: object

get_cost_estimateC

現在のコスト推定を取得する。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: コスト推定(success, estimate, warning)

Inputs: caller_agent_id. Returns: object

get_cost_summaryC

コストサマリーを取得する。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: コストサマリー(success, summary)

Inputs: caller_agent_id. Returns: object

get_dashboardC

ダッシュボード全体を取得する。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: ダッシュボード情報(success, dashboard)

Inputs: caller_agent_id. Returns: object

get_dashboard_summaryC

ダッシュボードのサマリーを取得する。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: サマリー情報(success, summary)

Inputs: caller_agent_id. Returns: object

get_global_memory_archive_summaryB

グローバルアーカイブのサマリー情報を取得する(全プロジェクト共通)。

※ Owner と Admin のみ使用可能。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: サマリー情報(success, summary)

Inputs: caller_agent_id. Returns: object

get_global_memory_summaryA

グローバルメモリのサマリー情報を取得する(全プロジェクト共通)。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: サマリー情報(success, summary)

Inputs: caller_agent_id. Returns: object

get_memory_archive_summaryB

アーカイブのサマリー情報を取得する。

※ Owner と Admin のみ使用可能。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: サマリー情報(success, summary)

Inputs: caller_agent_id. Returns: object

get_memory_entryB

キーでメモリエントリを取得する。

Args: key: エントリのキー caller_agent_id: 呼び出し元エージェントID(必須)

Returns: エントリ情報(success, entry または error)

Inputs: key (required), caller_agent_id. Returns: object

get_memory_summaryC

メモリのサマリー情報を取得する。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: サマリー情報(success, summary)

Inputs: caller_agent_id. Returns: object

get_model_profileC

現在のモデルプロファイルを取得する。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: プロファイル情報(success, active_profile, settings)

Inputs: caller_agent_id. Returns: object

get_model_profile_settingsC

モデルプロファイルの設定詳細を取得する。

Args: profile: プロファイル名(省略時は全プロファイル) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: プロファイル設定の詳細

Inputs: profile, caller_agent_id. Returns: object

get_optimal_personaB

タスクに最適なペルソナを取得する。

※ Admin のみ使用可能。

Args: task_description: タスクの説明文 caller_agent_id: 呼び出し元エージェントID(必須)

Returns: ペルソナ情報(success, persona)

Inputs: task_description (required), caller_agent_id. Returns: object

get_outputA

エージェントのtmux出力を取得する。

※ Owner と Admin のみ使用可能。

Args: agent_id: 対象エージェントID lines: 取得する行数(デフォルト: 50) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 出力内容(success, agent_id, lines, output または error)

Inputs: agent_id (required), lines, caller_agent_id. Returns: object

get_report_templateA

レポートテンプレートの内容を取得する。

指定されたレポートテンプレートの全文を返します。 テンプレートをコピーして、プレースホルダーを実際の内容に 置き換えてレポートを作成してください。

Args: template_name: テンプレート名(拡張子なし。例: "security", "general") caller_agent_id: 呼び出し元エージェントID(必須)

Returns: テンプレート内容(success, template_name, category, content または error)

Inputs: template_name (required), caller_agent_id. Returns: object

get_role_guideA

ロール別の振る舞いガイドを取得する。

templates/{role}.md からテンプレートを読み込み、 各ロールの責務、やること/やらないこと、振る舞いを取得します。

Args: role: ロール名(owner, admin, worker) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: ロールガイド(success, guide または error)

Inputs: role (required), caller_agent_id. Returns: object

get_screenshot_dirC

スクリーンショットディレクトリを取得する。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: ディレクトリ情報(success, path, exists)

Inputs: caller_agent_id. Returns: object

get_taskC

タスクの詳細を取得する。

Args: task_id: タスクID caller_agent_id: 呼び出し元エージェントID(必須)

Returns: タスク詳細(success, task または error)

Inputs: task_id (required), caller_agent_id. Returns: object

get_task_queueB

現在のタスクキューを取得する。

※ Owner と Admin のみ使用可能。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: キュー状態(success, queue)

Inputs: caller_agent_id. Returns: object

get_unhealthy_agentsB

異常なエージェント一覧を取得する。

※ Owner と Admin のみ使用可能。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 異常エージェント一覧(success, unhealthy_agents, count)

Inputs: caller_agent_id. Returns: object

get_unread_countB

エージェントの未読メッセージ数を取得する。

Args: agent_id: エージェントID caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 未読数(success, agent_id, unread_count)

Inputs: agent_id (required), caller_agent_id. Returns: object

get_workspace_templateB

特定テンプレートの詳細を取得する。

Args: template_name: テンプレート名 caller_agent_id: 呼び出し元エージェントID(必須)

Returns: テンプレート詳細(success, template または error)

Inputs: template_name (required), caller_agent_id. Returns: object

get_worktree_statusC

指定worktreeのgitステータスを取得する。

Args: repo_path: メインリポジトリのパス worktree_path: worktreeのパス caller_agent_id: 呼び出し元エージェントID(必須)

Returns: ステータス情報(success, status または error)

Inputs: repo_path (required), worktree_path (required), caller_agent_id. Returns: object

healthcheck_agentB

特定エージェントのヘルスチェックを実行する。

※ Owner と Admin のみ使用可能。

Args: agent_id: エージェントID caller_agent_id: 呼び出し元エージェントID(必須)

Returns: ヘルス状態(success, health_status)

Inputs: agent_id (required), caller_agent_id. Returns: object

healthcheck_allB

全エージェントのヘルスチェックを実行する。

※ Owner と Admin のみ使用可能。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 全ヘルス状態(success, statuses, summary)

Inputs: caller_agent_id. Returns: object

initialize_agentA

エージェントを初期化し、ロールテンプレートを渡して AI CLI を起動する。

create_agent で作成されたエージェントに対して、roles/ テンプレートを 初期プロンプトとして渡し、ターミナルで AI CLI を起動する。

※ Owner と Admin のみ使用可能。

Args: agent_id: 初期化するエージェントID prompt_type: プロンプトタイプ - "auto": roles/ テンプレートを自動読み込み(デフォルト) - "custom": custom_prompt をそのまま使用 - "file": custom_prompt をファイルパスとして読み込み custom_prompt: カスタムプロンプト(prompt_type が "custom" または "file" の場合) terminal: ターミナルアプリ(auto/ghostty/iterm2/terminal) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 初期化結果(success, agent_id, cli, prompt_source, message)

Inputs: agent_id (required), terminal, prompt_type, custom_prompt, +1 more. Returns: object

init_tmux_workspaceA

ターミナルを開いてtmuxワークスペース(グリッドレイアウト)を構築する。

ターミナルを先に起動し、その中でtmuxセッション作成・ペイン分割を行う。 セッションが既に存在する場合はattachのみ行う。 gtr が利用可能な場合、gtrconfig を自動確認・生成する。

レイアウト: ┌─────────────┬────────┬────────┬────────┐ │ pane 0 │ pane 1 │ pane 3 │ pane 5 │ │ (Admin) ├────────┼────────┼────────┤ │ (40%) │ pane 2 │ pane 4 │ pane 6 │ └─────────────┴────────┴────────┴────────┘ 左40% 右60% (Workers 1-6)

※ Owner のみ使用可能。

Args: working_dir: 作業ディレクトリのパス open_terminal: Trueでターミナルを開いて表示(デフォルト)、 Falseでバックグラウンド作成 auto_setup_gtr: gtr利用可能時に自動でgtrconfig設定(デフォルト: True) session_id: セッションID(省略時は None、指定時はディレクトリ構造に使用) enable_git: git 機能を有効化するか(省略時は config/.env を使用) caller_agent_id: 呼び出し元エージェントID(指定時はロールチェック)

Returns: 初期化結果(success, session_name, gtr_status, message または error)

Inputs: working_dir (required), enable_git, session_id, open_terminal, +2 more. Returns: object

list_agentsA

全エージェントの一覧を取得する。

ファイルに保存されたエージェント情報も含めて返す。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: エージェント一覧(success, agents, count, synced_from_file)

Inputs: caller_agent_id. Returns: object

list_global_memory_archiveA

グローバルアーカイブエントリ一覧を取得する(全プロジェクト共通)。

※ Owner と Admin のみ使用可能。

Args: limit: 最大結果数(デフォルト: 50) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: エントリ一覧(success, entries, count)

Inputs: limit, caller_agent_id. Returns: object

list_global_memory_entriesC

グローバルメモリエントリ一覧を取得する(全プロジェクト共通)。

Args: tags: フィルタリングするタグ(オプション) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: エントリ一覧(success, entries, count)

Inputs: tags, caller_agent_id. Returns: object

list_memory_archiveA

アーカイブされたメモリエントリ一覧を取得する。

※ Owner と Admin のみ使用可能。

Args: limit: 最大結果数(デフォルト: 50) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: エントリ一覧(success, entries, count)

Inputs: limit, caller_agent_id. Returns: object

list_memory_entriesA

メモリエントリ一覧を取得する。

Args: tags: フィルタリングするタグ(オプション) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: エントリ一覧(success, entries, count)

Inputs: tags, caller_agent_id. Returns: object

list_personasB

利用可能なペルソナ一覧を取得する。

※ Admin のみ使用可能。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: ペルソナ一覧(success, personas, count)

Inputs: caller_agent_id. Returns: object

list_report_templatesA

利用可能なレポートテンプレート一覧を取得する。

レポート作成時に使用できるテンプレートの一覧を返します。 テンプレートは「コード調査」「統合レポート」「汎用調査」の 3カテゴリに分類されています。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: テンプレート一覧(success, templates, categories)

Inputs: caller_agent_id. Returns: object

list_role_guidesA

利用可能なロールガイド一覧を取得する。

templates/ ディレクトリ内の .md ファイルを検索します。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: ロール名のリスト

Inputs: caller_agent_id. Returns: object

list_screenshotsC

スクリーンショット一覧を取得する(最新順)。

Args: limit: 最大取得件数(デフォルト: 10) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: スクリーンショット一覧(success, screenshots, count)

Inputs: limit, caller_agent_id. Returns: object

list_tasksB

タスク一覧を取得する。

Args: status: フィルターするステータス(オプション) agent_id: フィルターするエージェントID(オプション) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: タスク一覧(success, tasks, count または error)

Inputs: status, agent_id, caller_agent_id. Returns: object

list_workspace_templatesC

利用可能なテンプレート一覧を取得する。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: テンプレート一覧(success, templates, names)

Inputs: caller_agent_id. Returns: object

list_worktreesC

リポジトリのworktree一覧を取得する。

Args: repo_path: メインリポジトリのパス caller_agent_id: 呼び出し元エージェントID(必須)

Returns: worktree一覧(success, worktrees, count または error)

Inputs: repo_path (required), caller_agent_id. Returns: object

merge_completed_tasksC

完了タスクの作業ブランチを base_branch に統合する。

Inputs: repo_path (required), session_id (required), base_branch (required), strategy, +1 more. Returns: object

monitor_and_recover_workersC

Worker を監視し、異常時に復旧を実行する。

Inputs: caller_agent_id. Returns: object

open_sessionC

エージェントのtmuxセッションをターミナルアプリで開く。

優先順位: ghostty → iTerm2 → Terminal.app

※ Owner のみ使用可能。

Args: agent_id: エージェントID caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 開く結果(success, agent_id, session, message または error)

Inputs: agent_id (required), caller_agent_id. Returns: object

open_worktree_with_aiB

gtr ai コマンドでworktreeをAIツール(AI CLI)で開く。

gtr がインストールされている場合のみ使用可能。

※ Owner と Admin のみ使用可能。

Args: repo_path: リポジトリのパス branch: ブランチ名 caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 実行結果(success, branch, message または error)

Inputs: branch (required), repo_path (required), caller_agent_id. Returns: object

read_latest_screenshotC

最新のスクリーンショットを読み取る(Base64)。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 画像データ(success, filename, base64_data, mime_type)

Inputs: caller_agent_id. Returns: object

read_messagesB

エージェントのメッセージを読み取る。

Args: agent_id: エージェントID unread_only: 未読のみ取得するか message_type: フィルターするメッセージタイプ mark_as_read: 既読としてマークするか caller_agent_id: 呼び出し元エージェントID(必須)

Returns: メッセージ一覧(success, messages, count または error)

Inputs: agent_id (required), unread_only, mark_as_read, message_type, +1 more. Returns: object

read_screenshotB

指定したスクリーンショットを読み取る(Base64)。

Args: filename: ファイル名 caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 画像データ(success, filename, base64_data, mime_type)

Inputs: filename (required), caller_agent_id. Returns: object

register_agent_to_ipcC

エージェントをIPCシステムに登録する。

Args: agent_id: エージェントID caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 登録結果(success, agent_id, message)

Inputs: agent_id (required), caller_agent_id. Returns: object

remove_taskA

タスクを削除する。

※ Owner と Admin のみ使用可能。

Args: task_id: タスクID caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 削除結果(success, task_id, message または error)

Inputs: task_id (required), caller_agent_id. Returns: object

remove_worktreeB

git worktreeを削除する。

※ Owner と Admin のみ使用可能。

Args: repo_path: メインリポジトリのパス worktree_path: 削除するworktreeのパス force: 強制削除するか(デフォルト: False) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 削除結果(success, worktree_path, message または error)

Inputs: repo_path (required), worktree_path (required), force, caller_agent_id. Returns: object

reopen_taskC

終端タスクを再開する。

※ Admin のみ使用可能。

Args: task_id: 再開するタスクID reset_progress: 進捗率を 0 に戻すか caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 再開結果(success, task_id, message または error)

Inputs: task_id (required), reset_progress, caller_agent_id. Returns: object

report_task_completionA

Worker が Admin にタスク完了を報告する。

Worker はこのツールを使って Admin に作業結果を報告します。 Admin が受け取って dashboard を更新します。 自動的にメモリ保存とメトリクス更新も行います。

※ Worker のみ使用可能。

Args: task_id: 完了したタスクのID status: 結果ステータス("completed" | "failed") message: 完了報告メッセージ(作業内容の要約) summary: タスク結果のサマリー(メモリに保存、省略時はmessageを使用) caller_agent_id: 呼び出し元エージェントID(Worker のID)

Returns: 報告結果(success, message または error)

Inputs: status (required), message (required), task_id (required), summary, +1 more. Returns: object

report_task_progressA

Worker がタスクの進捗を報告する。

Worker は 10% ごとに進捗を報告することで、Admin と Owner が リアルタイムで作業状況を把握できます。

チェックリストを使用する場合、進捗率は自動計算されます。

※ Worker のみ使用可能。

Args: task_id: タスクID progress: 進捗率(0-100、10% 単位で報告推奨。checklist使用時は自動計算) message: 進捗メッセージ(現在の作業内容など、ログに追加されます) checklist: チェックリスト [{"text": "項目名", "completed": true/false}, ...] caller_agent_id: 呼び出し元エージェントID(Worker のID)

Returns: 報告結果(success, task_id, progress, message または error)

Inputs: task_id (required), message, progress, checklist, +1 more. Returns: object

reset_cost_counterA

コストカウンターをリセットする。

※ Owner のみ使用可能。

Args: caller_agent_id: 呼び出し元エージェントID(必須)

Returns: リセット結果(success, deleted_count, message)

Inputs: caller_agent_id. Returns: object

restore_from_global_memory_archiveA

グローバルアーカイブからエントリを復元する(全プロジェクト共通)。

※ Owner と Admin のみ使用可能。

Args: key: 復元するエントリのキー caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 復元結果(success, entry, message または error)

Inputs: key (required), caller_agent_id. Returns: object

restore_from_memory_archiveC

アーカイブからメモリエントリを復元する。

※ Owner と Admin のみ使用可能。

Args: key: 復元するエントリのキー caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 復元結果(success, entry, message または error)

Inputs: key (required), caller_agent_id. Returns: object

retrieve_from_global_memoryB

グローバルメモリから知識を検索する(全プロジェクト共通)。

Args: query: 検索クエリ tags: フィルタリングするタグ(オプション) limit: 最大結果数 caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 検索結果(success, entries, count)

Inputs: query (required), tags, limit, caller_agent_id. Returns: object

retrieve_from_memoryC

メモリから知識を検索する。

Args: query: 検索クエリ tags: フィルタリングするタグ(オプション) limit: 最大結果数 caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 検索結果(success, entries, count)

Inputs: query (required), tags, limit, caller_agent_id. Returns: object

save_to_global_memoryB

知識をグローバルメモリに保存する(全プロジェクト共通)。

保存先: ~/.multi-agent-mcp/memory/

Args: key: エントリのキー(一意な識別子) content: 保存するコンテンツ tags: タグのリスト(オプション) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 保存結果(success, entry, message)

Inputs: key (required), content (required), tags, caller_agent_id. Returns: object

save_to_memoryC

知識をメモリに保存する。

Args: key: エントリのキー(一意な識別子) content: 保存するコンテンツ tags: タグのリスト(オプション) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 保存結果(success, entry, message)

Inputs: key (required), content (required), tags, caller_agent_id. Returns: object

search_global_memory_archiveB

グローバルアーカイブを検索する(全プロジェクト共通)。

※ Owner と Admin のみ使用可能。

Args: query: 検索クエリ tags: フィルタリングするタグ(オプション) limit: 最大結果数 caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 検索結果(success, entries, count)

Inputs: query (required), tags, limit, caller_agent_id. Returns: object

search_memory_archiveA

アーカイブされたメモリを検索する。

prune で移動されたエントリを検索できる。

※ Owner と Admin のみ使用可能。

Args: query: 検索クエリ tags: フィルタリングするタグ(オプション) limit: 最大結果数 caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 検索結果(success, entries, count)

Inputs: query (required), tags, limit, caller_agent_id. Returns: object

send_commandB

指定エージェントにコマンドを送信する。

※ Owner と Admin のみ使用可能。

Args: agent_id: 対象エージェントID command: 実行するコマンド allow_dangerous: 危険判定コマンドを明示許可するか caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 送信結果(success, agent_id, command, message または error)

Inputs: command (required), agent_id (required), allow_dangerous, caller_agent_id. Returns: object

send_messageB

エージェント間でメッセージを送信する。

Args: sender_id: 送信元エージェントID receiver_id: 宛先エージェントID(Noneでブロードキャスト) message_type: メッセージタイプ(task_assign, task_complete, etc.) content: メッセージ内容 subject: 件名(オプション) priority: 優先度(low/normal/high/urgent) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 送信結果(success, message_id, message または error)

Inputs: content (required), sender_id (required), receiver_id (required), message_type (required), +3 more. Returns: object

send_taskB

タスク指示をファイル経由でエージェントに送信する。※ Owner と Admin のみ使用可能。

Args: agent_id: エージェントID task_content: タスク内容(Markdown形式) session_id: Issue番号または一意なタスクID auto_enhance: 自動拡張を行うか(デフォルト: True) branch_name: 作業ブランチ名(Admin 用、省略時は feature/{session_id}) report_template: レポートテンプレート名(例: "security", "general")。 指定するとテンプレートのファイルパスが Worker のタスク指示に注入される。 caller_agent_id: 呼び出し元エージェントID(必須)

Inputs: agent_id (required), session_id (required), task_content (required), branch_name, +3 more. Returns: object

set_cost_warning_thresholdB

コスト警告の閾値を設定する。

※ Owner のみ使用可能。

Args: threshold_usd: 新しい閾値(USD) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 設定結果(success, threshold, message)

Inputs: threshold_usd (required), caller_agent_id. Returns: object

switch_model_profileA

モデルプロファイルを切り替える。

※ Owner のみ使用可能。

Args: profile: 切り替え先プロファイル(standard/performance) caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 切り替え結果(success, previous_profile, current_profile, settings)

Notes: 永続化先は .multi-agent-mcp/.env の MCP_MODEL_PROFILE_ACTIVE のみ。 config.json には保存しない。

Inputs: profile (required), caller_agent_id. Returns: object

terminate_agentB

エージェントを終了する。

グリッドレイアウトではペインは維持され、再利用可能になる。

※ Owner と Admin のみ使用可能。

Args: agent_id: 終了するエージェントID caller_agent_id: 呼び出し元エージェントID(必須)

Returns: 終了結果(success, agent_id, message または error)

Inputs: agent_id (required), caller_agent_id. Returns: object

unlock_owner_waitB

Owner の待機ロックを手動解除する。

Args: reason: 解除理由 caller_agent_id: 呼び出し元エージェントID(必須) ctx: MCP Context

Returns: 解除結果

Inputs: reason, caller_agent_id. Returns: object

update_task_statusA

タスクのステータスを更新する。

※ Admin のみ使用可能。Worker は report_task_completion を使用してください。

Args: task_id: タスクID status: 新しいステータス(pending/in_progress/blocked/completed/failed/cancelled) progress: 進捗率(0-100) error_message: エラーメッセージ(failedの場合) caller_agent_id: 呼び出し元エージェントID(ロールチェック用)

Returns: 更新結果(success, task_id, status, message または error)

Inputs: status (required), task_id (required), progress, error_message, +1 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 90 tools

    Disambiguation3/5

    Many tools have clear distinct purposes, but there is significant overlap in areas like task management (create_task, enqueue_task, assign_task_to_agent, send_task) and memory retrieval (retrieve_from_memory, search_memory_archive, get_memory_entry). Also cleanup_workspace and cleanup_on_completion overlap, and check_gtr_available/check_gtrconfig are confusingly similar.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun pattern (get_, list_, create_, update_, delete_, remove_, send_, etc.). Minor deviations exist such as 'merge_completed_tasks' (verb_adjective_noun) and 'monitor_and_recover_workers' (compound verb) but these are understandable.

    Tool Count1/5

    90 tools is an extremely high count. Even for a multi-agent orchestration system, this is far beyond what an agent can reasonably navigate. The count is justified by the breadth of the domain, but it represents a severe cognitive load and should be split into multiple focused servers.

    Completeness4/5

    The domain coverage is remarkably thorough: agent lifecycle, task lifecycle, worktree management, messaging, memory, health checks, screenshots, cost tracking, and model profiles. Minor gaps include no explicit update_agent or update_worktree tools, but most operational cycles are complete.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers