🚀 iTerm2 Worktree MCP 服务器
这是一个模型上下文协议（MCP）服务器，它能自动管理 Git 工作树，并与 iTerm2 集成，专为 Claude Code 打造，可有效提升工作效率。
🚀 快速开始
📦 安装指南
将以下内容添加到 Claude Code 中：
claude mcp add -s user worktree -- python3 path/to/worktree_mcp_server.py
✨ 主要特性
核心工作树管理
- 创建工作树：创建一个带有功能分支的新 Git 工作树，并在新的 iTerm2 标签页中打开它。
- 关闭工作树：在验证工作树已清理且已推送更改后，安全地关闭工作树。
- 打开工作树：在新的 iTerm2 标签页中打开现有的工作树（如果已打开，可使用强制选项覆盖）。
导航与发现
- 活动工作树：列出所有 Git 工作树，并显示它们在哪些 iTerm2 标签页中运行。
- 切换到工作树：通过名称或特定标签页 ID 快速切换到工作树的 iTerm2 标签页。
智能标签页检测
- 动态发现：无需元数据文件，通过实时分析工作目录来查找标签页。
- 多标签页支持：显示在不同窗口中运行同一工作树的所有标签页。
- 窗口上下文：使用
thisWindow标志识别当前窗口中的标签页。
📚 详细文档
可用工具
| 工具 | 描述 | 参数 |
|---|---|---|
createWorktree |
创建新的工作树和分支，并在 iTerm2 标签页中打开 | feature_name、branch_name、worktree_folder、description、start_claude? |
closeWorktree |
验证、关闭并清理工作树 | worktree_name |
activeWorktrees |
列出所有工作树及其 iTerm2 标签页 | 无 |
switchToWorktree |
切换到工作树的 iTerm2 标签页 | worktree_name、tab_id? |
openWorktree |
在新标签页中打开现有的工作树 | worktree_name、force? |
工作流程
- 创建：使用
createWorktree命令，指定功能名称、分支名称和工作树文件夹，系统将自动创建工作树并切换到新的 iTerm2 标签页。 - 导航：使用
switchToWorktree或openWorktree命令，在工作树之间无缝切换。 - 监控：使用
activeWorktrees命令，查看所有工作树及其活动标签页。 - 开发：在与 iTerm2 完全集成的隔离工作树环境中进行开发。
- 关闭：使用
closeWorktree命令，验证更改已提交并推送，然后安全地移除工作树。
该服务器非常适合在隔离的 Git 环境中进行功能开发，并能与 iTerm2 实现无缝集成。