Claude Code Iterm Worktree MCP

🚀 iTerm2 Worktree MCP Server

Claude Codeに統合されたiTerm2を使用して、gitワークツリーの管理を自動化するModel Context Protocol (MCP)サーバーです。

https://github.com/user-attachments/assets/16188878-8fe8-450c-b2a3-cfd617d74f43

🚀 クイックスタート

このサーバーをClaude Codeに追加することで、gitワークツリーの管理を自動化できます。

📦 インストール

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とのシームレスな統合を提供します。