用途：当同时在多个项目或终端运行 Claude Code 时，claude-peers 让任意实例发现其他实例，查看其工作目录、git 仓库与摘要，并实时互发消息。
架构：broker 守护进程运行在 localhost:7899 并使用 SQLite 存储。每个 Claude Code 会话启动一个 MCP 服务器，启动时向 broker 注册、每秒轮询消息，并通过 claude/channel 协议推送入站消息，同时自动清理失效对等端。
主要能力：核心工具包括 list_peers（按 machine/directory/repo 范围发现实例，返回 id、cwd、gitRepo、gitBranch、summary、lastSeen）、send_message（按 ID 即时发送消息）、set_summary（描述当前工作供他人查看）、check_messages（手动轮询，通常不必要）。还提供 CLI：bun cli.ts status / peers / send <id> <消息> / kill-broker。
安装与使用：克隆仓库并安装依赖（git clone https://github.com/louislva/claude-peers-mcp.git ~/claude-peers-mcp；cd ~/claude-peers-mcp；bun install）；以用户范围注册 MCP 服务器：claude mcp add --scope user --transport stdio claude-peers -- bun ~/claude-peers-mcp/server.ts；启动需带通道支持：claude --dangerously-skip-permissions --dangerously-load-development-channels server:claude-peers。可配置环境变量 CLAUDE_PEERS_PORT（默认 7899）、CLAUDE_PEERS_DB（默认 ~/.claude-peers.db）。设置 OPENAI_API_KEY 后，启动时可用 gpt-5.4-nano 自动生成摘要。
适用场景：跨项目前后端协作、编辑前检查冲突、广播状态（如部署警告）、跨服务调试排查。
限制与要求：需要 Bun 与 Claude Code v2.1.80+，且必须通过 claude.ai 登录（通道不支持 API key 认证）。broker 仅绑定 127.0.0.1、无认证、消息不加密；失效对等端 60 秒后清理。