tmux claude MCP服务器
一个高效的模型上下文协议（MCP）服务器，通过tmux实现Claude实例的分层编排。特点a 桥式建筑 与传统的多服务器方法相比，这减少了85%的内存使用。
📸 截图
Demo 1 - Hierarchical Instance Management *分层编排，显示高管、经理和专家实例协同工作*
Demo 2 - Real-time Monitoring Dashboard *基于Web的监控仪表板，显示活动实例和系统指标*
🤖 对于Claude代码实例
新加入此存储库？ 如果您是Claude Code实例，请从 克劳德入门指南 以快速了解情况和实际示例。
概述
建筑创新
由于MCP记录的1:1 stdio架构，多个Claude实例无法直接访问MCP工具。我们的 桥式解决方案:
- 单共享MCP服务器进程（共50-70MB）
- 通过Bash实现多实例访问的轻量级网桥
- 与生成单独的服务器相比，内存减少了85%
- 集中状态管理的零竞争条件
核心MCP工具
- 生成：使用角色（执行官/经理/专家）创建新的Claude实例
- 发送：向实例发送文本/提示
- 读：读取实例的输出
- 列表：列出具有筛选功能的活动实例
- 终止：停止实例及其子实例（可选）
新功能
- VM集成：为开发环境提供完整的云VM管理
- 计划继续：在指定时间向所有tmux会话安排“请继续”消息
- 工作区模式：支持隔离（默认）和共享工作区模式
- Git集成：共享工作区的自动分支管理
- 冲突检测：主动识别合并冲突
- MCP Git工具：5个新的git操作工具（git_status、git_branch等）
- AI冲突解决：使用Claude智能解决合并冲突
- 性能优化：并行生成、消息批处理、缓存
- 监控仪表板：用于系统监控的实时web仪表板
项目结构
tmux-claude-mcp-server/
├── README.md # Project overview and usage
├── LICENSE # MIT license
├── package.json # Node.js dependencies
├── package-lock.json # Locked dependencies
├── .gitignore # Version control ignore patterns
├── src/ # Core source code
│ ├── simple_mcp_server.js # Main MCP server
│ ├── instance_manager.js # Instance lifecycle management
│ ├── mcp_tools.js # MCP tool implementations
│ ├── tmux_interface.js # tmux integration layer
│ ├── reliable_tmux_sender.js # High-reliability message delivery
│ ├── orchestration/ # Orchestration components
│ ├── dashboard/ # Web monitoring dashboard
│ ├── role_templates/ # Standardized role templates
│ └── workflow/ # Workflow orchestration system
│ ├── actions/ # Modular action implementations
│ ├── workflow_engine.cjs # Main workflow engine
│ └── run_workflow.cjs # Workflow runner CLI
├── scripts/ # Utility scripts
│ ├── mcp_bridge.js # Bridge for multi-instance MCP access
│ ├── scheduled_continue.js # Schedule "Plz continue" messages
│ ├── check/ # Session checking utilities
│ ├── restart/ # Session restart utilities
│ ├── utils/ # Shared utilities
│ │ └── time_parser.js # Time parsing for scheduling
│ └── api/ # API scripts for monitoring
├── docs/ # Documentation
│ ├── CHANGELOG.md # Version history
│ ├── CONTRIBUTING.md # Contribution guidelines
│ ├── WORKFLOW_GUIDE.md # Workflow system guide
│ ├── CLAUDE_GETTING_STARTED.md # Quick start for Claude instances
│ ├── DOCUMENTATION_INDEX.md # Documentation map
│ ├── scheduled_continue/ # Scheduled continue feature docs
│ │ ├── CLI_INTERFACE_DESIGN.md
│ │ ├── TIME_FORMAT_SPECIFICATION.md
│ │ └── SCHEDULING_MECHANISM_ANALYSIS.md
│ ├── analysis/ # Technical analysis & findings
│ ├── archive/ # Historical documentation
│ └── guides/ # User guides and specifications
├── tests/ # Test suites
│ ├── test_workflow_standalone.cjs # Standalone workflow tests
│ ├── unit/ # Unit tests
│ ├── integration/ # Integration tests
│ ├── e2e/ # End-to-end tests
│ └── performance/ # Performance benchmarks
├── workflows/ # Workflow system
│ ├── README.md # Workflow documentation
│ ├── CURRENT_STATUS.md # Current status and usage
│ ├── library/ # Reusable workflow components
│ ├── examples/ # Example workflows
│ ├── tests/ # Workflow test files
│ ├── scripts/ # Workflow utilities
│ ├── state/ # Workflow state storage
│ └── user/ # User-created workflows
├── state/ # Default state directory
├── config/ # Configuration files
├── logs/ # Log directory
└── vm-integration/ # Cloud VM management
├── README.md # VM integration documentation
├── vm_manager.js # Core VM management class
├── vm_cli.js # Command-line interface
├── vm_mcp_tools.js # MCP tools integration
├── integrate_vm_mcp.js # MCP server integration
├── setup-scripts/ # VM initialization scripts
│ └── claude-dev-setup.sh
└── tests/ # VM integration tests
└── test_vm_integration.js建筑
- 外部州立商店：第一阶段基于JSON文件的注册表，Redis为第二阶段做好准备+
- 项目隔离：每个Claude实例都使用
--project会话隔离标志 - 基于角色的访问：专家无法访问MCP工具，只有执行官/经理可以编排
- 分层命名:
exec_1,mgr_1_1,spec_1_1_1明确亲子关系 - 近乎免费的恢复：使用以下命令重新启动实例
--continue旗帜
代码收获
此实现收获并适应了现有tmux管理器代码库的约20-30%：
收获的组件
- tmux_interface.py →
src/tmux_interface.js-核心tmux操作 - instance.py →
src/instance_manager.js-实例生命周期管理 - manager.py →
src/instance_manager.js-登记和协调 - session_manager.py →
src/instance_manager.js-会话操作
废弃部件（60-70%）
- 所有CLI界面
- 模式匹配/监控系统
- 事件总线架构
- 配置管理
- 布局系统
安装
cd tmux-claude-mcp-server
npm install配置（必需）
关键： 您必须为所有Claude实例全局配置MCP服务器：
claude mcp add tmux-claude -s user node /path/to/tmux-claude-mcp-server/src/simple_mcp_server.js重要提示：
- 这
-s user需要标志才能使分层编排工作 - 这使得MCP服务器可供所有Claude实例使用
- 否则，生成的实例将无法访问MCP工具
- 看 MCP配置指南 了解详细信息
验证配置：
claude mcp list
# Should show: tmux-claude: node /path/to/simple_mcp_server.js用法
当Claude启动时（在上述正确配置后），MCP服务器会自动运行。
工具示例
培养一名高管
{
"name": "spawn",
"arguments": {
"role": "executive",
"workDir": "/jobs/auth_system",
"context": "# Executive: Auth System\\n\\nYou are responsible for orchestrating the implementation of a JWT authentication system..."
}
}执行产卵经理
{
"name": "spawn",
"arguments": {
"role": "manager",
"workDir": "/jobs/auth_system",
"context": "# Manager: Auth Implementation\\n\\nPlan and coordinate the JWT auth system implementation...",
"parentId": "exec_1"
}
}共享工作区经理（新）
{
"name": "spawn",
"arguments": {
"role": "manager",
"workDir": "/jobs/auth_system",
"context": "# Manager: Feature Implementation\\n\\nCoordinate multiple specialists...",
"parentId": "exec_1",
"workspaceMode": "shared" // Enable git integration
}
}产卵专家经理
{
"name": "spawn",
"arguments": {
"role": "specialist",
"workDir": "/jobs/auth_system",
"context": "# Specialist: User Model\\n\\nImplement the User model with Mongoose...",
"parentId": "mgr_1_1"
}
}将任务发送给专家
{
"name": "send",
"arguments": {
"instanceId": "spec_1_1_1",
"text": "Please implement the User model with email, password, and timestamps fields"
}
}阅读专家输出
{
"name": "read",
"arguments": {
"instanceId": "spec_1_1_1",
"lines": 50
}
}列出所有活动实例
{
"name": "list",
"arguments": {}
}列表管理器专家
{
"name": "list",
"arguments": {
"parentId": "mgr_1_1"
}
}终止已完成的专家
{
"name": "terminate",
"arguments": {
"instanceId": "spec_1_1_1"
}
}状态管理
外部州立商店（一期）
位于 ./state/instances.json:
{
"instances": {
"exec_1": {
"instanceId": "exec_1",
"role": "executive",
"parentId": null,
"sessionName": "claude_exec_1",
"projectDir": "/jobs/auth_system/exec_1",
"paneTarget": "claude_exec_1:0.0",
"status": "active",
"created": "2024-01-01T10:00:00Z",
"children": ["mgr_1_1"]
}
}
}实例目录结构
/jobs/auth_system/
├── exec_1/
│ ├── CLAUDE.md # Executive context
│ └── project files...
├── mgr_1_1/
│ ├── CLAUDE.md # Manager context
│ └── project files...
└── spec_1_1_1/
├── CLAUDE.md # Specialist context
└── implementation files...错误恢复
服务器使用Claude的实现了几乎免费的恢复 --continue 标志：
{
"name": "restart",
"arguments": {
"instanceId": "spec_1_1_1"
}
}这将：
- 检查实例是否真的已死亡
- 在同一项目目录中重新创建tmux会话
- 发射
claude --project . --continue - 克劳德自动从中断的地方继续
基于角色的访问控制
- 高管：完全访问所有MCP工具
- 经理：完全访问所有MCP工具
- 专家：无法访问MCP工具（仅使用标准Claude工具）
服务器通过检查调用者的角色并拒绝来自专家的MCP工具调用来强制执行此操作。
与Claude SDK集成
每个生成的实例：
- 用途
--project用于对话隔离 - 获取唯一的项目目录：
~/.claude/projects/-jobs-auth_system-/ - 维护单独的对话历史和待办事项
- 可以通过只读访问Claude的todo文件进行监控
相位演化
- 第一阶段：顺序执行，1个执行→ 1 经理→ 1 专家
- 第2阶段：有限的并行性，每个经理2-3名专家
- 第三期：完全并行，多个经理和专家
MCP接口旨在支持所有阶段，无需更改代码，只需配置差异。
计划继续功能
“计划继续”功能允许您在指定时间向所有tmux会话安排“请继续”消息。这对于自动化会话管理和确保在特定时间恢复工作非常有用。
基本用法
# Schedule in 30 minutes
node scripts/scheduled_continue.js "+30m"
# Schedule at 3:30 PM today
node scripts/scheduled_continue.js "15:30"
# Schedule at 9:45 AM with AM/PM format
node scripts/scheduled_continue.js "9:45am"
# Schedule using natural language
node scripts/scheduled_continue.js "in 2 hours"高级选项
# Custom message
node scripts/scheduled_continue.js "+1h" -m "Time to review progress"
# Dry run (test without executing)
node scripts/scheduled_continue.js "+5m" --dry-run
# Verbose logging
node scripts/scheduled_continue.js "+15m" --verbose
# Show help
node scripts/scheduled_continue.js --help支持的时间格式
- 相对的:
+30m,+2h,+90m - 24小时:
15:30,09:45,23:59 - 12小时:
3:30pm,9:45am,11:59PM - 自然语言:
"in 30 minutes","in 2 hours"
重要提示
- 进程必须保持运行，直到执行时间
- 系统睡眠/休眠可能会中断调度
- 最长调度窗口为24小时
- 会话在执行时重新验证
- 使用高可靠性消息传递
有关详细文档，请参阅：
测试
npm test # Run all tests
./scripts/run_all_tests.sh # Run comprehensive test suite发展
npm run dev # Start with file watching架构文件
有关完整的实施细节，请参阅：
docs/main/tmux-manager-MCP.md-MCP服务器规范docs/main/tmux-claude-implementation.md-完整的架构docs/main/tmux-mvp-implementation.md-第一阶段MVP方法docs/GIT_INTEGRATION_GUIDE.md-Git集成和工作区模式docs/WORKSPACE_MODES.md-详细的工作空间模式文档docs/GIT_INTEGRATION_REFINEMENT_PLAN.md-技术实施细节