Subagent MCP

Subagent MCP 是一个采用 MIT 许可证的本地 MCP，它允许 Codex 和其他兼容的 MCP 客户端通过一个标准化的生命周期来编排原生外部编码代理框架。发行版、仓库和命令名称均为 subagent-harness-mcp。

Windows 托管预览

0.1.0a1 是预发布版本，并非提供商就绪声明。该包包含 stdio MCP、修订后的本地状态、确定性假适配器、受保护的 Claude Code 托管适配器、保守的 Windows 运行时生命周期，以及一个可选加入的 localhost 设置/活动 UI。

模型 ID 和推理对象是提供商原生的不透明值。Subagent MCP 不包含模型允许列表、不选择回退、不启用使用额度，也不更改计费设置。

Claude 的原生 SDK 仅在回合开始后发布其提供商速率事件。因此，Subagent MCP 为每个托管进程禁用 1M 上下文、快速模式以及会话内使用额度命令。金丝雀在事件证明 allowed、isUsingOverage=false 并拒绝超额之前拒绝输出；普通回合需要该精确的持久化就绪证明，并且仍然会在任何后续不安全的速率/错误事件时中断。缺失或不安全的证据会暂停精确的运行时变体。所选的努力程度再次通过提供商原生进程环境固定，因此用户设置和技能无法替换它。

对于 0.1.0a1，普通 Claude 回合仅加载原生用户设置源。用户技能仍然可用，但项目/本地 CLAUDE.md、.claude 钩子、代理、技能和声明的项目 MCP 在信任门禁实现之前被禁用；这被报告为明确的能力差距。

Related MCP server: AgentHub

安装和检查

在 0.1.0a1 发布后，将精确的预发布版本安装到隔离的工具环境中：

uv tool install subagent-harness-mcp==0.1.0a1
subagent-harness-mcp --version
subagent-harness-mcp ui

也支持 pipx install subagent-harness-mcp==0.1.0a1。UI 仅在临时回环端口上打开，并随其进程停止。它是设置和只读活动，不是代理聊天控制台。

对于通用 MCP 客户端，使用带有固定参数的已安装可执行文件：

{
  "command": "subagent-harness-mcp",
  "args": ["serve"]
}

Windows 生命周期命令是显式的，并支持 --dry-run：

subagent-harness-mcp install --runtime <immutable-runtime-dir> --runtime-version <version> --dry-run
subagent-harness-mcp update --runtime <immutable-runtime-dir> --runtime-version <version> --dry-run
subagent-harness-mcp rollback --dry-run
subagent-harness-mcp register --client codex --dry-run
subagent-harness-mcp uninstall --client codex --dry-run

注册使用客户端的官方命令和精确回读。默认情况下，卸载会保留配置、状态、原生会话和工作树。

公共契约

MCP 为每个适配器公开相同的 13 个生命周期/配置工具。请参阅架构、适配器编写和威胁模型。版本化模式位于 schemas/：配置、适配器清单、标准化代理描述符和 MCP 工具。

Subagent MCP 仅拥有其显式配置、状态、数据和暂存运行时根。它从不使用 AgentBridge 状态，也不编辑现有的 Codex/Claude 配置、身份验证、缓存、记录或进程。

开发和安全性

有关确定性检查，请参阅 CONTRIBUTING.md；有关私有漏洞报告，请参阅 SECURITY.md。不要使用假适配器、静态检查或绿色 CI 作为实时提供商已就绪的证据。Subagent MCP 根据 MIT 许可证 发布。