AI导哈

Claude代理团队桥接服务

这是一个混合桥接服务，允许非Claude代理（如Codex CLI）参与Claude Code的原生代理团队系统，实现无缝通信。

  • by kouui
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 kouui/cc-teams-mcp

使用说明

cc队mcp

混合桥，允许非Claude代理（如Codex CLI）参与Claude Code的本地 代理团队.

分叉自 cs50victor/claude代码团队mcp --感谢cs50victor的原创作品！

这是什么？

Claude Code有一个内置的代理团队功能，具有事件驱动的消息传递功能——当新的对话发生时，消息会自动注入代理上下文。该项目提供 两台MCP服务器 将非Claude代理连接到这个本地系统：

  • MCP-A(claude-teams-bridge)：Claude Code团队负责生成、监视和关闭外部代理。通过以下方式监视收件箱文件并将消息注入外部代理tmux窗格 send-keys.
  • MCP-B(claude-teams-external)：由非Claude代理（例如Codex CLI）用于发送消息和管理任务。写入收件箱文件的邮件由Claude Code的本机运行时自动拾取。

通信路径

从→ 致 机制 延迟
克劳德→ Claude 本地消息注入（内置） ~即时
克劳德→ 非克劳德 克劳德写信到收件箱→ MCP-A观察者→ tmux发送密钥 ~秒
非克劳德→ Claude MCP-B写入收件箱→ Claude运行时自动注入 ~instant
非克劳德→ 非克劳德 MCP-B写入收件箱→ MCP-A观察者→ tmux发送密钥 ~秒

任何代理类型都不需要轮询。

安装

MCP-A：克劳德代码团队负责人

增添 .mcp.json （项目范围）或 ~/.claude.json （用户范围）：

{
  "mcpServers": {
    "claude-teams-bridge": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/kouui/cc-teams-mcp",
        "claude-teams-bridge"
      ],
      "allowedTools": ["*"]
    }
  }
}

MCP-B：适用于Codex CLI队友

增添 ~/.codex/config.toml:

[mcp_servers.claude-teams-external]
command = "uvx"
args = ["--from", "git+https://github.com/kouui/cc-teams-mcp", "claude-teams-external"]

当通过MCP-A生成Codex队友时，MCP-B会自动配置。

需求

工具

MCP-A： claude-teams-bridge

工具 说明
spawn_external_agent 在tmux中使用收件箱监视器生成外部代理
check_external_agent 检查代理状态：活动/死亡、观察者状态、终端输出
shutdown_external_agent 关闭tmux窗格、停止监视器、注销、重置任务

MCP-B： claude-teams-external

工具 说明
send_message 向任何团队成员发送消息（写入收件箱）
task_create 创建新任务
task_list 列出所有任务
task_get 获取任务详细信息
task_update 更新任务状态、所有者、依赖关系

配置

变量 描述 默认值
USE_TMUX_WINDOWS 在tmux窗口而不是窗格中生成 （未设置）

建筑

Claude Code (team-lead)
  ├── Native: TeamCreate / SendMessage / Task tools
  │   └── Event-driven message delivery (auto-injected turns)
  │
  ├── MCP-A (claude-teams-bridge)
  │   ├── Tools: spawn, check, shutdown
  │   └── Inbox watcher → tmux send-keys injection
  │
  └── Claude teammates (native communication, no MCP needed)

Non-Claude instance (e.g., Codex in tmux pane)
  ├── MCP-B (claude-teams-external)
  │   ├── Tools: send_message, task_*
  │   └── Writes to inbox files (read: false)
  └── Initial prompt: team info + MCP-B tool usage

文件布局

~/.claude/
├── teams/<team>/
│   ├── config.json
│   └── inboxes/
│       ├── team-lead.json
│       ├── codex-worker.json
│       └── .lock
└── tasks/<team>/
    ├── 1.json
    └── .lock

封装结构

src/claude_teams/
  common/          # Shared: models, messaging, tasks, teams, _filelock
  claude_side/     # MCP-A: server, spawner, registry, watcher, injector
  external_side/   # MCP-B: server

后端

目前支持： Codex CLI (codex), Gemini CLI (gemini).

后端 生成标志 注释
食品法典委员会 --dangerously-bypass-approvals-and-sandbox --no-alt-screen 提示为位置参数
双子座 --yolo --screen-reader --prompt-interactive --screen-reader 禁用TUI以获得干净的tmux输出

所有队友都会收到一个包含团队上下文（成员列表、MCP-B工具使用、沟通规则）的提示包装。

添加新后端需要扩展 BackendType 并添加 elif 分支机构在 build_spawn_command, wrap_prompt，以及 discover_backend_binaries 在 spawner.py.

发展

uv sync                          # install dependencies
uv run pytest tests/ -x          # run tests
uv run ruff check src/           # lint
uv run pyright src/              # type check

许可证

麻省理工学院

相关 MCP