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的本机运行时自动拾取。

通信路径

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

安装

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会自动配置。

需求

• Python 3.12+
• 终端复用器

工具

MCP-A： claude-teams-bridge

MCP-B： claude-teams-external

配置

建筑

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//
│   ├── config.json
│   └── inboxes/
│       ├── team-lead.json
│       ├── codex-worker.json
│       └── .lock
└── tasks//
    ├── 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).

所有队友都会收到一个包含团队上下文（成员列表、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

许可证

麻省理工学院