Tmux MCP Server

Tmux MCP サーバー

Claude Desktop が tmux セッションの内容を操作・表示できるようにする Model Context Protocol サーバーです。この連携により、AI アシスタントはターミナルセッションの読み取り、制御、監視を行えます。

機能

• tmux セッションの一覧表示と検索
• tmux ウィンドウとペインの表示と移動
• 任意のペインからターミナルの内容を取得して公開
• tmux ペインでコマンドを実行して結果を取得（自己責任でご利用ください ⚠️）
• 新しい tmux セッションとウィンドウの作成
• サイズをカスタマイズしてペインを水平方向または垂直方向に分割
• tmux セッション、ウィンドウ、ペインの終了

こちらの短い動画をぜひご覧ください！

前提条件

• Node.js
• tmux がインストールされ、実行中であること

使用方法

Claude Desktop の設定

この MCP サーバーを Claude Desktop の設定に追加します。

"mcpServers": {
  "tmux": {
    "command": "npx",
    "args": ["-y", "tmux-mcp"]
  }
}

MCP サーバーのオプション

使用するコマンドラインシェルを任意で指定できます。指定しない場合は、デフォルトで bash が使用されます。

"mcpServers": {
  "tmux": {
    "command": "npx",
    "args": ["-y", "tmux-mcp", "--shell-type=fish"]
  }
}

MCP サーバーがシェルを必要とするのはコマンド実行時のみです。これは終了ステータスを正しく読み取るためです。

利用可能なリソース

• tmux://sessions - すべての tmux セッションを一覧表示
• tmux://pane/{paneId} - 指定した tmux ペインの内容を表示
• tmux://command/{commandId}/result - 実行したコマンドの結果

利用可能なツール

• list-sessions - アクティブな tmux セッションをすべて一覧表示
• find-session - 名前で tmux セッションを検索
• list-windows - tmux セッション内のウィンドウを一覧表示
• list-panes - tmux ウィンドウ内のペインを一覧表示
• capture-pane - tmux ペインの内容を取得
• create-session - 新しい tmux セッションを作成
• create-window - tmux セッション内に新しいウィンドウを作成
• split-pane - オプションのサイズを指定して、tmux ペインを水平方向または垂直方向に分割
• kill-session - ID で tmux セッションを終了
• kill-window - ID で tmux ウィンドウを終了
• kill-pane - ID で tmux ペインを終了
• execute-command - tmux ペインでコマンドを実行
• get-command-result - 実行したコマンドの結果を取得