Conductor MCP (conductor-mcp)

导线mcp

一个轻量级的MCP服务器，用于从任何终端编排Claude Code工作人员。

不需要Chrome。 将TabzChrome的编排能力带到iTerm、Kitty、Alacritty、Windows终端、WezTerm或您喜欢的任何终端。

功能（35工具）

核心工作器工具

会话和窗口管理

窗格管理

实时监控

同步

弹出通知

钩子（事件驱动）

布局和大小调整

配置

面向用户的设置（语音、配置文件、布局/时间）在指挥家tui设置面板中进行管理。规范配置： ~/.config/conductor/config.json.

关键差异

tmux MCP execute-command 立即发送键，这会导致Claude/Codex提示创建换行符而不是提交。 send_keys 使用可选延迟修复此问题：

# What tmux MCP does (broken for Claude):
tmux send-keys -t session "prompt" Enter  # Too fast!

# What conductor-mcp does (works):
send_keys(session, "prompt")  # submit=True by default
# Internally:
#   tmux send-keys -t session "prompt"
#   sleep 0.8  # Wait for input detection
#   tmux send-keys -t session Enter

# Just type without submitting:
send_keys(session, "partial text", submit=False)

安装

# Clone the repo
git clone https://github.com/GGPrompts/conductor-mcp.git
cd conductor-mcp

# Install dependencies
pip install mcp edge-tts

# Add to Claude Code
claude mcp add conductor -- python /path/to/conductor-mcp/server.py

需求

• Python 3.10+
• tmux 3.0+
• 边缘tts(pip install edge-tts)
• mpv、ffplay或vlc（用于音频播放）
• beads CLI（可选，用于spawn_worker上下文注入）
• git（用于工作台管理）

音频挂钩设置（可选）

对于Claude使用工具或完成任务时的自动TTS公告：

1.复制钩子脚本

mkdir -p ~/.claude/hooks/scripts
cp reference/state-tracker.sh ~/.claude/hooks/scripts/
cp reference/audio-announcer.sh ~/.claude/hooks/scripts/
chmod +x ~/.claude/hooks/scripts/*.sh

2.添加到Claude设置（~/.Claude/settings.json）

{
  "env": {
    "CLAUDE_AUDIO": "1",
    "CLAUDE_VOICE": "en-US-AndrewNeural",
    "CLAUDE_RATE": "+20%"
  },
  "hooks": {
    "SessionStart": [{"matcher": "", "hooks": [{"type": "command", "command": "~/.claude/hooks/scripts/state-tracker.sh session-start", "timeout": 2}]}],
    "PreToolUse": [{"matcher": "", "hooks": [{"type": "command", "command": "~/.claude/hooks/scripts/state-tracker.sh pre-tool", "timeout": 1}]}],
    "PostToolUse": [{"matcher": "", "hooks": [{"type": "command", "command": "~/.claude/hooks/scripts/state-tracker.sh post-tool", "timeout": 1}]}],
    "Stop": [{"matcher": "", "hooks": [{"type": "command", "command": "~/.claude/hooks/scripts/state-tracker.sh stop", "timeout": 1}]}]
  }
}

3.可用语音

列车长自动为工作人员分配独特的声音。可用语音：

• 美国：AriaNeural、GuyNeural、JennyNeural、DavisNeural、AmberNeural、AndrewNeural、EmmaNeural、BrianNeural
• 英国：SoniaNeural、RyanNeural
• AU：娜塔莎神经，威廉神经

音频功能

• 互斥锁：直接 speak() 通话优先于挂机通知
• 防抖：快速发布的工具受到限制
• 缓存：生成的音频缓存在 /tmp/claude-audio-cache/

使用示例

基本：将钥匙发送给工人

# Send and submit (default behavior)
send_keys(session="worker-1", keys="Fix the auth bug")

# Send without submitting
send_keys(session="worker-1", keys="partial input", submit=False)

# Announce status
speak(text="Task assigned to worker 1")

工人视觉网格

# Create a 2x2 grid (4 panes)
grid = create_grid(layout="2x2", start_dir="/path/to/project")

# Spawn workers in each pane
for pane_id, issue_id in zip(grid["panes"], issues):
    spawn_worker_in_pane(pane_id=pane_id, issue_id=issue_id, project_dir="/path/to/project")
    speak(text=f"Spawned {issue_id}")

来自克劳德桌面（非tmux）

# Bootstrap tmux environment first
session = create_session(name="workers", start_dir="/project")

# Then create grid and spawn workers
create_grid(layout="2x2", session="workers")

实时监控

# Watch a pane's output
watch_pane(pane_id="%5")

# Read recent output
output = read_watch(pane_id="%5", lines=20)

# Stop watching
stop_watch(pane_id="%5")

工人与信号的协调

# Conductor waits for worker to finish
result = await wait_for_signal(channel="done-BD-abc", timeout_s=600)

# Worker signals completion
send_signal(channel="done-BD-abc")

参考

中的遗留实现 reference/:

• audio-announcer.sh -带缓存、互斥、去抖动的TTS
• state-tracker.sh -Claude钩子用于状态跟踪
• tmux-status-claude.sh -Tmux状态栏集成

许可证

麻省理工学院