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 標誌識別當前窗口中的標籤頁。

📚 詳細文檔

可用工具

工作流程

1. 創建：使用 createWorktree 命令，指定功能名稱、分支名稱和工作樹文件夾，系統將自動創建工作樹並切換到新的 iTerm2 標籤頁。
2. 導航：使用 switchToWorktree 或 openWorktree 命令，在工作樹之間無縫切換。
3. 監控：使用 activeWorktrees 命令，查看所有工作樹及其活動標籤頁。
4. 開發：在與 iTerm2 完全集成的隔離工作樹環境中進行開發。
5. 關閉：使用 closeWorktree 命令，驗證更改已提交併推送，然後安全地移除工作樹。

該服務器非常適合在隔離的 Git 環境中進行功能開發，並能與 iTerm2 實現無縫集成。