使用说明

多代理MCP

AI CLI（克劳德码/Codex/反重力（agy）/光标）+tmux+git工作树使用（或非git目录）的多代理工作流的MCP服务器。

概要

此MCP服务器通过tmux会话管理多个AI CLI实例，实现并行工作。 MCP_ENABLE_GIT=false 中描述的场景，使用下列步骤创建明细表，以便在概念设计中分析体量的周长。

千兆模式

模式｜设置｜行为｜ |------|------|------| 有效（默认） 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 中，单击将条目添加到文档注册表。

阶层构造

所有者 （1体）：整体指挥、任务分解、Issue制作
管理员 （1个）：工作器管理、进度管理、仪表板更新
工人（标准6个/最多16个）：执行分配的任务

対応 AI CLI 一覧

CLI	识别子	备考
克劳德代码	`claude` 在默认配置中可用
食品法典委员会	`codex` 在默认配置中可用
反重力（agy）	`agy` 在默认配置中可用。需要事先设置终端CLI（后述）
光标	`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" 对较大场景进行渲染期间已观察到该故障。

eligibility 要件

要在agy上启动代理，需要具备Antigravity使用资格的谷歌账户。一些Google Workspace账户即使登录成功 agy --print 运行时 Eligibility check failed: ... not eligible for Antigravity 中所述修改相应参数的值。在这种情况下，可以使用个人的谷歌账户请委托Workspace管理员启用Antigravity的使用。

実起动确认手顺（手动）

请手动确认已解决的帐户实际会话将继续（在本项目的测试代码中 agy 的明细栏样式中定义的设置。

小规模配置（Admin+Worker1） ai_cli="agy" 中所述修改相应参数的值。
在tmux窗格中 --prompt-interactive 仅在启动后的响应中不结束确保会话继续。
在管理员/工作器之间发送IPC消息，并在窗格中 [IPC] 新しいメッセージ 通知显示，确认agy对此作出反应并重新开始作业（一次不结束）。

必要条件

Python 3.10以上
终端多路复用器
uv（推荐）或pip

最短设置

在MCP客户端上 multi-agent-mcp 列表框中，此格式对应于条目“无”。 Claude/Codex使用以下CLI示例，在Antigravity（agy）/Cursor等中CLI子命令不同的情况下与之后的JSON设定例相同 command=uvx / args=[...] 来修改标记元素的显示属性。
重新启动客户端并重新连接到MCP服务器。
在客户端上 init_tmux_workspace("/path/to/project", session_id="issue-123") 执行初始化工作区。在非git目录中 enable_git=false 的双曲正切值。

安装

可以直接从GitHub安装（不需要存储库的clone）。

在CLI中添加

在正常运行中 --reinstall 建议无。添加命令请参阅以下“添加/删除设置（与重新安装不同）”。

添加/删除设置（与重新安装不同）

克劳德

# 追加（--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

法典

# 追加（--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重新安装最新版本。

备注: --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

90个工具

会话管理（4个）

Tool	说明
`init_tmux_workspace` 打开终端构建tmux工作区（Admin1+Worker1-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` ｜并行创建多个工作器并分配任务｜

执行命令（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` 获取工作树列表（仅在git有效时）
`remove_worktree` 删除工作树（仅在git有效时）
`assign_worktree` 向代理分配工作树（仅在git有效时）
`get_worktree_status` 获取工作树的git状态（仅在git有效时）
`check_gtr_available` 确认是否可以使用gtr（git-worktree-runner）（仅在git有效时）
`open_worktree_with_ai` 在gtr ai中用AI工具打开worktree（仅在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的情况下将完成任务的工作分支部署到集成分支

5个IPC/消息传递

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` 更新任务状态（仅管理员）
`assign_task_to_agent` 将任务分配给代理（管理员专用）
`list_tasks` 获取任务列表
`report_task_progress` 工作器报告任务进展
`report_task_completion` 工作器向管理员报告任务完成（仅限工作器）
`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 中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。

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` 自动将任务分配给空闲的工作器
`get_task_queue` 获取当前任务队列

健康检查（6个）

Tool	说明
`healthcheck_agent` 执行特定代理的健康检查
`healthcheck_all` 执行所有代理的健康检查
`get_unhealthy_agents` 获取异常代理列表
`attempt_recovery` 尝试恢复代理
`full_recovery` 完全恢复工作器（agent/worktree重新创建+任务重新分配）
`monitor_and_recover_workers` 执行工作器监视和阶段恢复（attempt→full→failed化）

佩尔索纳（3个）

Tool	说明
`detect_task_type` 从任务说明中发现任务类型
`get_optimal_persona` 获取最适合任务的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）

代理人

主要字段： id, role, status, tmux_session, working_dir, worktree_path, current_task
网格/CLI关系： session_name, window_index, pane_index, ai_cli, ai_bootstrapped

仪表板/任务

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")

文档

各系统详见：

｜文档｜说明｜ | ------------ | ---- | | 文件系统｜永久文件/目录结构和命名约定｜ | IPC系统｜代理间消息通信的结构｜ | 存储器系统知识持久化、共享和存档功能 | 工作树系统基于Git worktree的隔离工作环境 | Dashboard系统任务状态管理和仪表板显示 | Healthcheck系统 | Worker监视、段阶复旧、daemon运用| | Merge Guide 完成任务分支的集成操作

环境变数

｜变量｜默认｜说明｜ |------|-----------|------| | MCP_MCP_DIR ｜.multi-agent-mcp｜MCP设置目录名｜ | MCP_ENABLE_GIT ｜启用真｜git前提功能（在假中允许非git目录）｜ | MCP_ENABLE_WORKTREE 是否使用作业树（MCP_ENABLE_GIT=false 的情况下无效） | MCP_ENABLE_CURSOR_IMAGE_ROUTING 是否启用图像任务的Cursor路由（默认为false） | MCP_WINDOW_NAME_MAIN 主窗口名称（Admin+Worker1-6） | MCP_WINDOW_NAME_WORKER_PREFIX 工作人员-添加工作器窗口名称前缀 | MCP_EXTRA_WORKER_ROWS ｜2｜添加窗口的行数｜ | MCP_EXTRA_WORKER_COLS ｜5｜添加窗口的列数｜ | MCP_WORKERS_PER_EXTRA_WINDOW 10｜添加窗口的工作er数｜ | MCP_COST_WARNING_THRESHOLD_USD 10.0成本警告阈值（USD） | MCP_ESTIMATED_TOKENS_PER_CALL 每一次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 到Codex的Enter重发间隔（毫秒） | MCP_SEND_COOLDOWN_SECONDS 在向tmux连续发送时夹持的最小等待秒数 | MCP_DEFAULT_TERMINAL 终端应用程序（auto:cmux→ghostty→iterm2→terminal） | MCP_MODEL_PROFILE_ACTIVE 模型配置文件（standard/performance） | MCP_MODEL_PROFILE_STANDARD_CLI ｜codex｜standard配置文件的AI CLI｜ | MCP_MODEL_PROFILE_STANDARD_ADMIN_MODEL ｜gpt-5.5｜standard配置文件管理员模型｜ | MCP_MODEL_PROFILE_STANDARD_WORKER_MODEL ｜gpt-5.5｜standard概要文件的Worker模型｜ | MCP_MODEL_PROFILE_STANDARD_MAX_WORKERS 6｜standard配置文件的工作器上限｜ | MCP_MODEL_PROFILE_STANDARD_ADMIN_THINKING_TOKENS \4000｜standard配置文件中的管理员思考令牌数｜ | 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配置文件管理员模型｜ | MCP_MODEL_PROFILE_PERFORMANCE_WORKER_MODEL ｜gpt-5.5｜performance配置文件的Worker模型｜ | MCP_MODEL_PROFILE_PERFORMANCE_MAX_WORKERS 16性能概要文件的工作器上限 | MCP_MODEL_PROFILE_PERFORMANCE_ADMIN_THINKING_TOKENS 30000｜性能配置文件中的管理员思考令牌数｜ | MCP_MODEL_PROFILE_PERFORMANCE_WORKER_THINKING_TOKENS \4000｜performance配置文件的Worker思考令牌数｜ | MCP_MODEL_PROFILE_PERFORMANCE_ADMIN_REASONING_EFFORT ｜高性能配置文件的管理员推理强度｜ | MCP_MODEL_PROFILE_PERFORMANCE_WORKER_REASONING_EFFORT 高性能概要文件的工作器推理强度 | MCP_PROJECT_ROOT ｜-｜项目根目录（.env读取用）｜ | MCP_CLI_DEFAULT_CLAUDE_ADMIN_MODEL ｜Claude CLI的Admin默认模型｜ | MCP_CLI_DEFAULT_CLAUDE_WORKER_MODEL ｜sonnet｜Claude CLI的Worker默认模型｜ | MCP_CLI_DEFAULT_CODEX_ADMIN_MODEL ｜gpt-5.5｜Codex CLI的管理员默认模型｜ | MCP_CLI_DEFAULT_CODEX_WORKER_MODEL ｜gpt-5.5｜Codex CLI的Worker默认模型｜ | MCP_CLI_DEFAULT_AGY_ADMIN_MODEL Agy CLI的管理员默认模型 | MCP_CLI_DEFAULT_AGY_WORKER_MODEL Agy CLI的Worker默认模型 | MCP_CLI_DEFAULT_CURSOR_ADMIN_MODEL ｜composer-1.5｜Cursor CLI的管理员默认模型｜ | MCP_CLI_DEFAULT_CURSOR_WORKER_MODEL ｜composer-1.5｜Cursor CLI的Worker默认模型｜ | MCP_WORKER_CLI_MODE 工作器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 ｜真｜是否严格应用质量门｜ | MCP_MEMORY_MAX_ENTRIES 内存的最大条目数 | MCP_MEMORY_TTL_DAYS ｜90｜内存条目的保留期（天）｜ | MCP_SCREENSHOT_EXTENSIONS ｜[“.png”，“.jpg”，…]｜视为屏幕快照的扩展名｜

工作器上限为 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 执行时，将自动生成所有可设置的变量，并带有注释。

首选项:

环境变数（最优先）
.multi-agent-mcp/.env 文件
缺省值

enable_git 仅在运行时按以下优先级解决：

init_tmux_workspace(enable_git=...) 参数
.multi-agent-mcp/config.json 的，之 enable_git
环境变数/ .env
默认值（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或未初始化工作区。

対処法:

tmux -V 确认tmux的安装
init_tmux_workspace 在中初始化工作区

工作器未响应（启动检测）

原因：AI CLI进程可能已挂起。

対処法:

healthcheck_agent 确认状态
attempt_recovery 在中尝试轻量恢复
如果你仍然没有改善 full_recovery 完全恢复

无法读取dashboard.md

原因：YAML Front Matter格式可能已损坏。

対処法:

.multi-agent-mcp/{session_id}/dashboard/dashboard.md 删除
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

许可证

麻省理工学院

使用说明

多代理MCP

概要

千兆模式

阶层构造

対応 AI CLI 一覧

agy（Antigravity CLI）的设置

必要条件

最短设置

安装

在CLI中添加

添加/删除设置（与重新安装不同）

直接写入配置文件

关于自动更新

确认设置

90个工具

会话管理（4个）

代理管理（6个）

执行命令（5个）

Git Worktree管理（7个）

create_worktree参数协议

合并（1个）

5个IPC/消息传递

仪表板/任务管理（15个）

create_task的metadata运用

update_task_status迁移约束

调查报告输出规则

Gtrconfig（3个）

模板（6个）

3个调度器

健康检查（6个）

佩尔索纳（3个）

内存管理（19个）

4个屏幕快照

3个模型配置文件

switch_model_profile的方针

主要字段（公共I/F）

代理人

仪表板/任务

使用例

文档

环境变数

目录结构

按项目设置

gitignore 推奨

开发（面向供应商）

故障排除

找不到tmux会话

工作器未响应（启动检测）

无法读取dashboard.md

MCP服务器未启动

许可证

相关 MCP

小红书MCP服务

Figma MCP集成工具

MCP 协议测试服务器

Flomo笔记服务

Unity编辑器AI集成插件

规范工作流管理工具