Claude Desktop이 tmux 세션 콘텐츠와 상호작용하고 볼 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다. 이 통합을 통해 AI 비서가 터미널 세션을 읽고, 제어하며, 관찰할 수 있습니다.

특징

• TMUX 세션 목록 및 검색
• TMUX 창과 창 보기 및 탐색
• 어떤 창에서든 터미널 콘텐츠를 캡처하고 노출
• tmux 창에서 명령어 실행 및 결과 가져오기 (사용은 본인 책임 ⚠️ 하에 )
• 새로운 TMUX 세션 및 창 생성
• 수평 또는 수직으로 분할 및 맞춤 크기
• tmux 세션, 창, 창 종료

이 짧은 영상을 확인해 보세요!

선수 조건

• Node.js
• TMUX 설치 및 실행 중

사용

Claude 데스크탑 구성

이 MCP 서버를 Claude Desktop 구성에 추가하세요:

MCP 서버 옵션

선택적으로 사용 중인 명령줄 셸을 지정할 수 있는데, 지정하지 않으면 기본값은 [[T0]입니다.

MCP 서버는 명령을 실행할 때만 셸을 알아야 종료 상태를 제대로 읽을 수 있습니다.

이용 가능한 자료

• tmux://sessions - 모든 tmux 세션 목록
• tmux://pane/{paneId} - 특정 TMUX 창의 콘텐츠 보기

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