cs50victor/claude-code-teams-mcp

Claude Codeのエージェントチームプロトコルを任意のMCPクライアント向けに実装する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ではありません。リリース間には壊れやすい変更があります。

Claude Code (.mcp.json):

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

要件

• Python 3.12+
• TMUX
• PATH上の少なくとも1つのコーディングエージェント: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