libtmux-mcp server

공식

libtmux 기반의 tmux MCP 서버

git-pull.com에서 보기

Libtmux MCP(으)로 무엇을 할 수 있나요?

  • tmux 상태 검사 — list_sessions, capture_pane, get_pane_info 또는 search_panes를 사용하여 세션, 창, 패널 세부 정보를 읽습니다.
  • 패널에 입력 전송 — send_keys, send_keys_batch, run_command 또는 paste_text를 사용하여 대상 패널에 명령어나 텍스트를 입력합니다.
  • 세션 생성 및 구성 — create_session, create_window 및 split_window를 통해 이름이 지정된 세션, 창 및 분할 패널을 생성합니다.
  • tmux 객체 제거 — kill_session, kill_window, kill_pane 또는 kill_server를 사용하여 세션, 창, 패널 또는 전체 서버를 종료합니다.
  • 셸 기록 억제 — suppress_persistent_history로 패널을 실행하여 테스트 실행 및 일회성 명령어가 영구 셸 기록에 남지 않도록 합니다.

문서

libtmux-mcp¶

libtmux와 FastMCP를 기반으로 구축된 AI 에이전트를 위한 터미널 제어.

이 서버는 tmux의 객체 계층 구조(세션, 윈도우, 페인)를 MCP 도구로 매핑합니다. 일부 도구는 상태를 읽습니다. 일부는 변경합니다. 일부는 파괴합니다. 이 구분은 명시적이며 강제됩니다.

경고

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

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

uvx pipx pip install

쿨다운 구성 ?

로컬 사용자 프로젝트

사용자 프로젝트

사용자 프로젝트

프로젝트 전역

사용자 프로젝트

uvx가 설치된 상태에서:

$ claude mcp add tmux -- uvx libtmux-mcp

뒤로

종속성 쿨다운

위의 쿨다운 구성 체크박스를 사용하여 활성화 또는 비활성화합니다. 이 설정은 활성화된 후 쿨다운이 작동하는 방식을 선택합니다.

쿨다운이란 무엇인가요?

쿨다운은 새로 업로드된 패키지를 설치하기 전에 커뮤니티가 공급망 공격을 발견할 시간을 갖도록 설치를 지연시킵니다. 대부분의 패키지 관리자는 기본적으로 적용하지 않으며, 도구 설정의 전역 설정을 통해 선택할 수 있습니다.

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

빠른 시작

설치, 연결, 첫 결과 얻기. 2분 이내.

빠른 시작

도구

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

도구

프롬프트

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

프롬프트

리소스

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

리소스

안전 등급

읽기 전용, 변경, 파괴. 상태를 변경하는 요소 파악.

안전 등급

클라이언트 설정

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

MCP 클라이언트

할 수 있는 일¶

읽기 전용 검사¶

아무것도 변경하지 않고 tmux 상태를 읽습니다.

list_sessions · capture_pane · capture_since · snapshot_pane · get_pane_info · find_pane_by_position · search_panes · wait_for_text · wait_for_content_change · display_message · call_readonly_tools_batch

변경 작업¶

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

파괴 작업¶

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

kill_session · kill_window · kill_pane · kill_server · call_destructive_tools_batch

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

libtmux-mcp는 Bash, Zsh, Fish에 대해 최선의 기록 억제 기능을 제공합니다. run_command에 대한 MCP 호출은 기본적으로 경량 명령 억제를 사용합니다. 새 셸을 생성할 때 suppress_persistent_history=true를 사용하여 더 강력한 디스크 미기록 제어를 선택하십시오.

프롬프트

최선의 디스크 미기록 셸 기록 제어 기능을 갖춘 "checks"라는 tmux 세션을 만들고, 초기 페인에서 pytest -q을 실행한 후 결과를 보여주세요.

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

이러한 제어는 기록 노이즈를 줄여줍니다. 명령을 비밀로 만들지는 않습니다. 셸별 동작은 기록 억제, 서버 기본값은 구성, 기타 관찰 표면은 안전 등급을 참조하십시오.

모든 도구 찾아보기 →

멘탈 모델¶

  • 객체 계층 구조 — 세션은 윈도우를 포함하고, 윈도우는 페인을 포함합니다 (개념)
  • 읽기 vs. 변경 — 일부 도구는 관찰하고, 일부는 작동하며, 일부는 파괴합니다 (안전 등급)
  • tmux가 진실의 원천 — 서버는 tmux에서 읽고 쓰며, 캐싱하거나 추상화하지 않습니다