libtmux-mcp server
公式libtmux を利用した tmux MCP サーバー
Libtmux MCPで何ができますか？
- tmux 状態の検査 — セッションの一覧表示、ペイン出力のキャプチャ、または特定のテキストのペイン検索を要求します。
- tmux 構造の管理 — セッションの名前変更、ペインのサイズ変更、レイアウトの選択、またはウィンドウのセッション間移動を行います。
- ペイン内でのコマンド実行 — セッション/ウィンドウの作成、ペインの分割、キーストロークの送信、またはシェルコマンドの実行を行います。
- ペインプロセスの制御 — テキストやバッファの貼り付け、ペイン出力のパイプ、または環境変数やオプションの設定を行います。
- tmux オブジェクトの破棄 — ペインのスクロールバックのクリア、セッション/ウィンドウ/ペインの終了、またはバッファの削除を行います。
- シェル履歴の抑制 — ディスク履歴制御なしでセッションやウィンドウを作成し、テスト実行をよりクリーンにします。
ドキュメント
AIエージェント向けのターミナル制御。libtmux と FastMCP 上に構築されています。
このサーバーは、tmuxのオブジェクト階層（セッション、ウィンドウ、ペイン）を、要求された操作ごとにグループ化されたMCPツールにマッピングします。サーバーは、選択されたグループをMCPツールの境界で強制します。
[!warning] 警告 プレアルファ版。 APIは変更される可能性があります。フィードバック歓迎。
uvx がインストールされている場合:
$ claude mcp add tmux -- uvx libtmux-mcp
クイックスタート
ツール
プロンプト
リソース
信頼モデル
クライアント設定
できること
検査 inspect
tmuxの状態とターミナル出力を要求します。
list_sessions · capture_pane · capture_since · snapshot_pane · get_pane_info · find_pane_by_position · search_panes · wait_for_text · display_message · call_read_tools_batch
管理 manage
tmuxの構造や表示を変更します。
rename_session · resize_pane · select_layout · select_pane · move_window · enter_copy_mode · load_buffer · wait_for_channel
実行 execute
ペインのプロセスを開始または駆動し、後の実行を制御できる状態を保存します。
create_session · create_window · split_window · respawn_pane · send_keys · send_keys_batch · run_command · paste_text · paste_buffer · pipe_pane · set_option · set_environment
破棄 teardown
tmuxオブジェクトまたは保持されたスクロールバックを削除します。元に戻せません。
clear_pane · kill_session · kill_window · kill_pane · kill_server · delete_buffer
例: テスト実行を永続的な履歴から除外する
libtmux-mcpは、Bash、Zsh、Fish向けのベストエフォート型の履歴抑制を提供します。run_command へのMCP呼び出しは、デフォルトで軽量なコマンド抑制を使用します。新しいシェルを作成するときは、suppress_persistent_history=true でより強力なディスク非書き込み制御を選択できます。
[!note] プロンプト 「checks」というtmuxセッションを、ベストエフォート型のディスク非書き込みシェル履歴制御付きで作成し、その初期ペインで
pytest -qを実行して、結果を表示してください。
エージェントは create_session を suppress_persistent_history=true 付きで呼び出し、返された SessionInfo から active_pane_id を再利用し、オーバーライドなしで run_command を呼び出します。create_window、split_window、または respawn_pane の同じスポーンオプションは、その呼び出しが開始するプロセスにのみ適用されます。
これらの制御は履歴のノイズを減らしますが、コマンドを秘密にするものではありません。シェル固有の動作については 履歴抑制、サーバーのデフォルトについては 設定、その他の観測面については 信頼モデル を参照してください。
メンタルモデル
- オブジェクト階層 — セッションはウィンドウを含み、ウィンドウはペインを含みます（概念）
- ツールセット — inspect、manage、execute、teardown。それぞれがグループ化するもの（信頼モデル）
- tmuxが真実の源 — サーバーはtmuxから読み取り、tmuxに書き込みます。キャッシュや抽象化は一切行いません