termmux

termmux

コマンドラインまたは stdio MCP サーバーとして、ローカルの tmux を操作します。 セッションの一覧表示、作成、名前変更、終了、ウィンドウとペインの管理、 ペインへのキー送信や、表示中の出力の取得ができます。

すべての操作は、注入可能なエグゼキューターを介して、引数配列を使い本物の tmux バイナリを実行します （execFile を使用し、シェル文字列は使いません）。そのため、 セッション名やキーのテキストがシェル構文として再解釈されることはありません。 存在しないセッション名を指定すると、tmux 自身のエラーが返されます。 tmux サーバーが実行されていない場合、一覧表示の呼び出しは空のリストを返します。 これは tmux が報告する空の状態と同じです。

インストール

npx -y @reneturcios/termmux mcp

ホストに tmux バイナリが必要です（コンテナーイメージには含まれていないため、コンテナーで実行すると tmux が利用できないと報告されます）。

CLI

termmux mcp
termmux list-sessions
termmux create-session <name> [window] [start-dir]
termmux kill-session <name>
termmux list-windows <session>
termmux capture <session> [pane]
termmux send <session> <keys...>
termmux --version

終了コード：0 は成功、1 は tmux エラー、2 は使用方法のエラーです。

MCP ツール

ツール	用途
list_sessions	すべての tmux セッションを一覧表示します
create_session	新しい tmux セッションを作成します
kill_session	名前を指定して tmux セッションを終了します
list_windows	tmux セッションのウィンドウを一覧表示します
create_window	tmux セッションに新しいウィンドウを作成します
kill_window	tmux セッションのウィンドウを終了します
list_panes	tmux セッションのペインを一覧表示します。ウィンドウを 1 つ指定することもできます
send_keys	tmux ペインにキー（コマンドラインまたはキー名）を送信します
capture_pane	tmux ペインの表示中の内容をテキストとして取得します
rename_session	tmux セッションの名前を変更します
select_window	tmux セッションのウィンドウを選択（アクティブ化）します
get_session_info	tmux セッション 1 つの詳細を取得します

MCP クライアントの設定：

{
  "mcpServers": {
    "termmux": {
      "command": "npx",
      "args": ["-y", "@reneturcios/termmux", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/termmux          # MCP server (tmux unavailable in-image)
docker run --rm ghcr.io/cloudcorprecords/termmux --version

開発

npm install
npm run build
npm test

MIT ライセンス。