NT

nickgnd/tmux-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

306 stars 57 forks 品質 60 トレンド 19MIT

nickgnd/tmux-mcp は、https://github.com/nickgnd/tmux-mcp. からインポートされた MCP サーバー候補です。

概要

nickgnd/tmux-mcp は、https://github.com/nickgnd/tmux-mcp. からインポートされた MCP サーバー候補です。

概要(AI 翻訳)

Claude Desktopがtmuxセッション内容とやり取り・閲覧できるようにするModel Context Protocolサーバー。この統合により、AIアシスタントは端末セッションを読み込み、制御し、観察できます。

特徴

  • TMUXセッションのリストおよび検索
  • TMUXウィンドウやペインの表示とナビゲーション
  • 任意のペインから終端コンテンツをキャプチャ・公開する
  • tmuxペインでコマンドを実行し、結果を取得する(使用は自己責任⚠️で)
  • 新しいTMUXセッションとウィンドウの作成
  • 水平または縦分割のパネルで、サイズをカスタマイズ可能
  • tmuxセッション、ウィンドウ、ペインをキルする

この短い動画をチェックして、ワクワクしてみてください!

前提条件

  • Node.js
  • TMUXのインストールおよび稼働

使用法

Claude Desktop の設定

このMCPサーバーをClaude Desktopの設定に追加してください:

MCPサーバーの選択肢

使っているコマンドラインシェルを指定することもできますが、指定しなければデフォルトはbashになります。

MCPサーバーは、コマンドを実行する際のみシェルを認識し、その終了ステータスを正しく読み取る必要があります。

利用可能なリソース

  • tmux://sessions - すべてのtmuxセッションをリストアップ
  • tmux://pane/{paneId} - 特定のTMUXパネルの内容を見る

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

Tmux MCP Server

Model Context Protocol server that enables Claude Desktop to interact with and view tmux session content. This integration allows AI assistants to read from, control, and observe your terminal sessions.

Features

  • List and search tmux sessions
  • View and navigate tmux windows and panes
  • Capture and expose terminal content from any pane
  • Execute commands in tmux panes and retrieve results (use it at your own risk ⚠️)
  • Create new tmux sessions and windows
  • Split panes horizontally or vertically with customizable sizes
  • Kill tmux sessions, windows, and panes

Check out this short video to get excited!

Prerequisites

  • Node.js
  • tmux installed and running

Usage

Configure Claude Desktop

Add this MCP server to your Claude Desktop configuration:

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

MCP server options

You can optionally specify the command line shell you are using, if unspecified it defaults to bash

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

The MCP server needs to know the shell only when executing commands, to properly read its exit status.

Available Resources

  • tmux://sessions - List all tmux sessions
  • tmux://pane/{paneId} - View content of a specific tmux pane
  • tmux://command/{commandId}/result - Results from executed commands

Available Tools

  • list-sessions - List all active tmux sessions
  • find-session - Find a tmux session by name
  • list-windows - List windows in a tmux session
  • list-panes - List panes in a tmux window
  • capture-pane - Capture content from a tmux pane
  • create-session - Create a new tmux session
  • create-window - Create a new window in a tmux session
  • split-pane - Split a tmux pane horizontally or vertically with optional size
  • kill-session - Kill a tmux session by ID
  • kill-window - Kill a tmux window by ID
  • kill-pane - Kill a tmux pane by ID
  • execute-command - Execute a command in a tmux pane
  • get-command-result - Get the result of an executed command
GitHub で README 全文を見る

インストール

npx -y tmux-mcp
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

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