iTerm2統合のGitワークツリー管理MCPサービスで多ブランチ開発フローを最適化

たんさく

Claude Code Iterm Worktree MCP

iTerm2と統合されたGitワークツリー管理MCPサービスで、ワークツリーの作成、閉じる、ナビゲーション、スマートタブ検出機能を提供し、多ブランチ開発フローを最適化します。

開発者ツールバージョン管理 #Gitワークツリー #iTerm2統合 #ブランチ管理 #ターミナルナビゲーション .Python

スコア : 2.5ポイント

ダウンロード数 : 4.4K

更新時間 : 2025-07-24

サイトを開く

iTerm2 Worktree MCP Serverとは？

これはModel Context Protocol (MCP)サーバーで、開発者がiTerm2ターミナルを通じてGitワークツリーを管理するのを支援します。ワークツリーの作成、閉じる、切り替えができ、iTerm2で自動的に新しいタブを開きます。

iTerm2 Worktree MCP Serverの使い方は？

Claude Codeを使ってMCPサーバーを追加した後、コマンドを使用してワークツリーの作成、閉じる、切り替えができます。このサーバーはiTerm2内のワークツリータブを自動検出し、ナビゲーション機能を提供します。

適用シーン

複数のGitブランチを同時に処理する必要がある開発者に適しています。各機能に独立したワークツリーを作成し、iTerm2で直感的なタブ管理を提供します。

主要機能

ワークツリーを作成する

指定された特徴名、ブランチ名、フォルダに基づいて新しいGitワークツリーを作成し、iTerm2で新しいタブを開きます。

ワークツリーを閉じる

ワークツリーの変更をコミットしてプッシュしたことを確認した後、安全にワークツリーを閉じてクリーンアップします。

ワークツリーを開く

既存のワークツリーを新しいiTerm2タブで開き、既存のタブを強制的に上書きすることもできます。

ワークツリーを切り替える

特定のワークツリーのiTerm2タブに素早く切り替えることができ、名前またはタブIDで選択できます。

アクティブなワークツリーを表示する

すべての実行中のワークツリーとそれに対応するiTerm2タブの情報をリスト表示します。

スマートタブ検出

メタデータファイルに依存せず、iTerm2タブの作業ディレクトリをリアルタイムで分析してワークツリーを検出します。

利点

作業効率を向上させる：自動化操作により、ワークツリーの手動管理時間を削減します。

ユーザー体験を向上させる：iTerm2と深く統合され、より直感的なタブ管理を提供します。

開発環境を分離する：各ワークツリーは独立しているため、異なるブランチ間の干渉を避けます。

制限

iTerm2とClaude Codeのサポートが必要です。

Gitが設定されていないプロジェクトには適用できません。

初心者ユーザーには一定の学習曲線が必要かもしれません。

使い方

MCPサーバーをインストールする

Claude Codeコマンドを使用して、iTerm2 Worktree MCPサーバーをあなたの環境に追加します。

ワークツリーを作成する

特徴名、ブランチ名、ワークツリーフォルダを指定して新しいワークツリーを作成します。

アクティブなワークツリーを表示する

`activeWorktrees`コマンドを使用して、現在のすべてのワークツリーとそれに関連付けられたiTerm2タブを表示します。

ワークツリーを切り替える

`switchToWorktree`コマンドを使用して、特定のワークツリーのタブに素早く切り替えます。

ワークツリーを閉じる

ワークツリーの変更をコミットしてプッシュしたことを確認した後、`closeWorktree`コマンドを使用してワークツリーを閉じてクリーンアップします。

使用例

新しい機能のワークツリーを作成する

新しい機能を開発する際に、独立したワークツリーを作成してメインブランチに影響を与えないようにします。

古い機能のワークツリーに切り替える

現在の機能の開発が完了した後、以前のワークツリーに素早く切り替えて開発を続けます。

完了したワークツリーを閉じる

機能の開発が完了した後、安全にワークツリーを閉じてリソースをクリーンアップします。

よくある質問

このMCPサーバーにはどのようなツールのサポートが必要ですか？

ワークツリーが正しく作成されたかどうかをどうやって知ることができますか？

ワークツリーを閉じた場合、復元できますか？

異なるiTerm2ウィンドウで同じワークツリーを使用できますか？

🚀 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フラグを使用して、現在のウィンドウ内のタブを識別します。

📚 ドキュメント

利用可能なツール

ツール	説明	パラメータ
`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 - 変更がコミットされてプッシュされていることを確認した後、安全にワークツリーを削除します。