cs50victor/claude-code-teams-mcp

모든 MCP 클라이언트에 대해 Claude Code의 에이전트 팀 프로토콜을 구현하는 MCP 서버입니다.

https://github.com/user-attachments/assets/531ada0a-6c36-45cd-8144-a092bb9f9a19

Claude Code에는 내장 에이전트 팀 기능(공유 작업 목록, 에이전트 간 메시징, TMUX 기반 스폰 포함)이 있지만, 프로토콜은 내부적이며 자체 도구와 밀접하게 연결되어 있습니다. 이 MCP 서버는 그 프로토콜을 독립 실행형 MCP 서버로 재구현하여 Claude Code, OpenCode 또는 MCP를 사용하는 모든 MCP 클라이언트에 사용할 수 있게 합니다. Claude Code 내부 구조를 깊이 탐구한 결과입니다. PR 환영합니다.

설치

**릴리스 태그에 핀(예: @v0.1.1)에 고정하라, main가 아닙니다. 릴리스 사이에 발생하는 변경 사항이 있습니다.

클로드 코드 (.mcp.json):

OpenCode (~/.config/opencode/opencode.json):

요구 사항

• 파이썬 3.12+
• TMUX
• PATH에 최소 하나의 코딩 에이전트: Claude Code (claude) 또는 OpenCode (opencode)
• OpenCode 팀원은 OPENCODE_SERVER_URL와 claude-teams MCP가 해당 인스턴스에서 연결되어 있어야 합니다.

구성

https://github.com/user-attachments/assets/531ada0a-6c36-45cd-8144-a092bb9f9a19

Claude Code has a built-in agent teams feature (shared task lists, inter-agent messaging, tmux-based spawning), but the protocol is internal and tightly coupled to its own tooling. This MCP server reimplements that protocol as a standalone MCP server, making it available to any MCP client: Claude Code, OpenCode, or anything else that speaks MCP. Based on a deep dive into Claude Code’s internals. PRs welcome.

Install

Pin to a release tag (e.g. @v0.1.1), not main. There are breaking changes between releases.

Claude Code (.mcp.json):

{
  "mcpServers": {
    "claude-teams": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/cs50victor/[email protected]", "claude-teams"]
    }
  }
}

OpenCode (~/.config/opencode/opencode.json):

{
  "mcp": {
    "claude-teams": {
      "type": "local",
      "command": ["uvx", "--from", "git+https://github.com/cs50victor/[email protected]", "claude-teams"],
      "enabled": true
    }
  }
}

Requirements

• Python 3.12+
• tmux
• At least one coding agent on PATH: Claude Code (claude) or OpenCode (opencode)
• OpenCode teammates require OPENCODE_SERVER_URL and the claude-teams MCP connected in that instance

Configuration

Without CLAUDE_TEAMS_BACKENDS, the server auto-detects the connecting client and enables only its backend. Set it explicitly to enable multiple backends:

{
  "mcpServers": {
    "claude-teams": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/cs50victor/[email protected]", "claude-teams"],
      "env": {
        "CLAUDE_TEAMS_BACKENDS": "claude,opencode",
        "OPENCODE_SERVER_URL": "http://localhost:4096"
      }
    }
  }
}

Tools