libtmux-mcp server
公式libtmux を利用した tmux MCP サーバー
Libtmux MCPで何ができますか？
- tmux の状態を検査 —
list_sessions、capture_pane、またはget_pane_infoを使用して、セッション、ウィンドウ、ペインの読み取り専用スナップショットを要求します。 - ペイン内でコマンドを実行 — アシスタントに
run_commandまたはsend_keysでシェルコマンドを実行させたり、キーストロークを送信させたりします。バッチ操作も含みます。 - tmux オブジェクトを管理 —
create_window、split_window、select_paneなどのツールを使用して、ウィンドウとペインを作成、分割、サイズ変更、または選択します。 - tmux リソースを破棄 —
kill_sessionやkill_serverなどの破壊的なツールを使用して、セッション、ウィンドウ、ペイン、またはサーバー全体を破棄します。 - シェル履歴を抑制 —
suppress_persistent_history=trueを指定してセッションまたはウィンドウを開始し、テスト実行が永続的なシェル履歴に残らないようにします。
ドキュメント
libtmux-mcp¶
AIエージェントのためのターミナル制御。libtmuxとFastMCP上に構築されています。
このサーバーは、tmuxのオブジェクト階層（セッション、ウィンドウ、ペイン）をMCPツールにマッピングします。一部のツールは状態を読み取ります。一部は状態を変更します。一部は破壊します。その違いは明確にされており、強制されます。
警告
プレアルファ版。 APIは変更される可能性があります。フィードバック歓迎です。
Claude Code Claude Desktop Codex CLI Gemini CLI Cursor Grok CLI Antigravity opencode
uvx pipx pip install
クールダウンを設定 ?
ローカル ユーザー プロジェクト
ユーザー プロジェクト
ユーザー プロジェクト
プロジェクト グローバル
ユーザー プロジェクト
uvxがインストールされている場合:
$ claude mcp add tmux -- uvx libtmux-mcp
戻る
依存関係のクールダウン
上記の_クールダウンの設定_チェックボックスを使用して有効または無効にします。これらの設定は、一度有効にするとクールダウンがどのように動作するかを選択します。
クールダウンとは何ですか？
クールダウンは、新しくアップロードされたパッケージの取得を遅らせ、コミュニティがインストール前にサプライチェーン攻撃を発見する時間を確保します。ほとんどのパッケージマネージャーはデフォルトでこれを適用しません。ツールの設定でグローバル設定を介してオプトインします。
cooldowns.devで詳細を学ぶ · Datadog Security Labsのレポート。
クイックスタート
インストール、接続、最初の結果を取得。2分以内。
クイックスタート
ツール
意図と安全性レベルごとにグループ化されたすべてのツール。
ツール
プロンプト
クライアントがモデルにレンダリングする4つのワークフローレシピ。
プロンプト
リソース
tmux:// URIを介したtmux階層のスナップショットビュー。
リソース
安全性レベル
読み取り専用、変更、破壊。何が状態を変更するかを把握します。
安全性レベル
クライアント設定
Claude Desktop、Claude Code、Cursorなどの設定ブロック。
MCPクライアント
できること
読み取り専用で検査
何も変更せずにtmuxの状態を読み取ります。
list_sessions · capture_pane · capture_since · snapshot_pane · get_pane_info · find_pane_by_position · search_panes · wait_for_text · display_message · call_readonly_tools_batch
変更操作
tmuxオブジェクトを作成または変更します。
create_session · send_keys · send_keys_batch · run_command · paste_text · create_window · split_window · select_pane · select_window · move_window · resize_pane · pipe_pane · set_option · call_mutating_tools_batch
破壊的操作
tmuxオブジェクトを破棄します。元に戻せません。
kill_session · kill_window · kill_pane · kill_server · call_destructive_tools_batch
例：テスト実行を永続的な履歴から除外する
libtmux-mcpは、Bash、Zsh、およびFish向けのベストエフォート型の履歴抑制を提供します。run_commandへのMCP呼び出しは、デフォルトで軽量なコマンド抑制を使用します。新しいシェルを作成するときは、suppress_persistent_history=trueでより強力なディスク書き込みなしの制御をオプトインできます。
プロンプト
「checks」という名前のtmuxセッションを、ベストエフォートのディスク書き込みなしのシェル履歴制御付きで作成し、初期ペインでpytest -qを実行して、結果を表示してください。
エージェントはcreate_sessionをsuppress_persistent_history=true付きで呼び出し、返されたSessionInfoからactive_pane_idを再利用し、オーバーライドなしでrun_commandを呼び出します。create_window、split_window、またはrespawn_paneの同じスポーンオプションは、その呼び出しが開始するプロセスにのみ適用されます。
これらの制御は履歴のノイズを減らしますが、コマンドを秘密にするものではありません。シェル固有の動作については履歴抑制を、サーバーのデフォルトについては設定を、その他の監視面については安全性レベルを参照してください。
すべてのツールを閲覧 →
メンタルモデル
- オブジェクト階層 — セッションはウィンドウを含み、ウィンドウはペインを含む（概念）
- 読み取りと変更 — 一部のツールは観察し、一部は作用し、一部は破壊する（安全性レベル）
- tmuxが真実の源 — サーバーはtmuxから読み取り、tmuxに書き込む。キャッシュや抽象化はしない