libtmux-mcp server

공식

libtmux 기반의 tmux MCP 서버

git-pull.com에서 보기이 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 도구로 매핑합니다. 일부 도구는 상태를 읽습니다. 일부는 상태를 변경합니다. 일부는 파괴합니다. 그 구분은 명시적이며 강제됩니다.

Warning

프리 알파. API는 변경될 수 있습니다. 피드백 환영합니다.

Claude Code Claude Desktop Codex CLI Gemini CLI Cursor Grok CLI Antigravity opencode

uvx pipx pip install

Configure cooldowns ?

Local User Project

User Project

User Project

Project Global

User Project

With uvx installed:

$ claude mcp add tmux -- uvx libtmux-mcp

Back

Dependency cooldowns

위의 Configure cooldowns 체크박스를 사용하여 활성화 또는 비활성화합니다. 이 설정은 쿨다운이 활성화된 후 어떻게 동작할지 결정합니다.

쿨다운이란 무엇인가요?

쿨다운은 새로 업로드된 패키지를 가져오는 것을 지연시켜 커뮤니티가 설치 전에 공급망 공격을 발견할 시간을 확보하게 합니다. 대부분의 패키지 관리자는 기본적으로 이를 적용하지 않습니다 — 도구의 설정에서 전역 옵션으로 선택해야 합니다.

cooldowns.dev · Datadog Security Labs writeup에서 자세히 알아보세요.

Quickstart

설치, 연결, 첫 결과 확인. 2분 이내.

Quickstart

Tools

의도와 안전 등급별로 그룹화된 모든 도구.

Tools

Prompts

클라이언트가 모델에 렌더링하는 네 가지 워크플로 레시피.

Prompts

Resources

tmux:// URI를 통한 tmux 계층 구조의 스냅샷 뷰.

Resources

Safety tiers

읽기 전용, 변경, 파괴. 무엇이 상태를 바꾸는지 알아두세요.

Safety tiers

Client setup

Claude Desktop, Claude Code, Cursor 및 기타 도구를 위한 구성 블록.

MCP Clients

할 수 있는 작업¶​

Inspect readonly (읽기 전용 검사)¶​

아무것도 변경하지 않고 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

Act mutating (변경 작업)¶​

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

Destroy destructive (파괴 작업)¶​

tmux 객체를 제거합니다. 되돌릴 수 없습니다.

kill_session · kill_window · kill_pane · kill_server · call_destructive_tools_batch

예시: 테스트 실행을 영구 기록에서 제외하기¶​

libtmux-mcp는 Bash, Zsh, Fish에 대해 최선형(best-effort) 기록 억제를 제공합니다. run_command에 대한 MCP 호출은 기본적으로 경량 명령 억제를 사용합니다. 새 셸을 만들 때는 suppress_persistent_history=true로 더 강력한 디스크 기록 방지 제어를 선택할 수 있습니다.

Prompt

"checks"라는 tmux 세션을 최선형 디스크 기록 방지 셸 기록 제어로 만들고, 초기 팬에서 pytest -q를 실행한 다음 결과를 보여주세요.

에이전트는 create_session을 suppress_persistent_history=true와 함께 호출하고, 반환된 SessionInfo에서 active_pane_id를 재사용한 다음, 재정의 없이 run_command을 호출합니다. create_window, split_window 또는 respawn_pane에 대한 동일한 스폰 옵션은 해당 호출이 시작하는 프로세스에만 적용됩니다.

이러한 제어는 기록 노이즈를 줄일 뿐, 명령을 비밀로 만들지는 않습니다. 셸별 동작은 History suppression, 서버 기본값은 Configuration, 기타 관찰 표면은 Safety tiers를 참조하세요.

Browse all tools →

개념 모델¶​

  • 객체 계층 — 세션은 윈도우를 포함하고, 윈도우는 팬을 포함합니다 (Concepts)
  • 읽기 vs. 변경 — 일부 도구는 관찰하고, 일부는 작업하며, 일부는 파괴합니다 (Safety tiers)
  • tmux가 진실의 원천 — 서버는 tmux에서 읽고 쓰며, 캐시하거나 추상화하지 않습니다