claude-code-iterm-worktree-mcp

🚀 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? |

工作流程

1. 创建：使用 createWorktree 命令，指定功能名称、分支名称和工作树文件夹，系统将自动创建工作树并切换到新的 iTerm2 标签页。
2. 导航：使用 switchToWorktree 或 openWorktree 命令，在工作树之间无缝切换。
3. 监控：使用 activeWorktrees 命令，查看所有工作树及其活动标签页。
4. 开发：在与 iTerm2 完全集成的隔离工作树环境中进行开发。
5. 关闭：使用 closeWorktree 命令，验证更改已提交并推送，然后安全地移除工作树。

该服务器非常适合在隔离的 Git 环境中进行功能开发，并能与 iTerm2 实现无缝集成。