libtmux-mcp server

chính thức

Máy chủ MCP tmux được hỗ trợ bởi libtmux

Xem trên git-pull.comDùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với Libtmux MCP?

Kiểm tra trạng thái tmux — Yêu cầu liệt kê các phiên, chụp nội dung pane, hoặc tìm kiếm văn bản cụ thể trong các pane.
Quản lý cấu trúc tmux — Đổi tên phiên, thay đổi kích thước pane, chọn bố cục, hoặc di chuyển cửa sổ giữa các phiên.
Thực thi lệnh trong pane — Tạo phiên/cửa sổ, chia pane, gửi tổ hợp phím, hoặc chạy lệnh shell.
Kiểm soát tiến trình trong pane — Dán văn bản hoặc bộ đệm, chuyển hướng nội dung pane, hoặc đặt biến môi trường và tùy chọn.
Gỡ bỏ đối tượng tmux — Xóa vùng cuộn của pane, hủy phiên/cửa sổ/pane, hoặc xóa bộ đệm.
Tắt lịch sử shell — Tạo phiên hoặc cửa sổ với kiểm soát lịch sử không ghi đĩa để chạy thử nghiệm sạch hơn.

Tài liệu

Điều khiển terminal cho các tác nhân AI, được xây dựng trên libtmux và FastMCP.

Máy chủ này ánh xạ hệ thống phân cấp đối tượng của tmux — sessions, windows, panes — thành các công cụ MCP được nhóm theo thao tác mà chúng yêu cầu. Máy chủ thực thi các nhóm đã chọn tại ranh giới công cụ MCP.

[!warning] Cảnh báo Tiền-alpha. API có thể thay đổi. Phản hồi được hoan nghênh.

Với uvx đã được cài đặt:

$ claude mcp add tmux -- uvx libtmux-mcp

Bắt đầu nhanh

Công cụ

Lời nhắc

Tài nguyên

Mô hình tin cậy

Thiết lập máy khách

MCP Clients

Những gì bạn có thể làm

Kiểm tra inspect

Yêu cầu trạng thái tmux và đầu ra terminal.

list_sessions · capture_pane · capture_since · snapshot_pane · get_pane_info · find_pane_by_position · search_panes · wait_for_text · display_message · call_read_tools_batch

Quản lý manage

Thay đổi cấu trúc hoặc cách trình bày của tmux.

rename_session · resize_pane · select_layout · select_pane · move_window · enter_copy_mode · load_buffer · wait_for_channel

Thực thi execute

Khởi động hoặc điều khiển các tiến trình trong pane, hoặc lưu trữ trạng thái có thể kiểm soát việc thực thi sau này.

create_session · create_window · split_window · respawn_pane · send_keys · send_keys_batch · run_command · paste_text · paste_buffer · pipe_pane · set_option · set_environment

Dọn dẹp teardown

Xóa các đối tượng tmux hoặc scrollback đã lưu. Không thể hoàn tác.

clear_pane · kill_session · kill_window · kill_pane · kill_server · delete_buffer

Ví dụ: giữ các lần chạy kiểm thử ngoài lịch sử lưu trữ

libtmux-mcp cung cấp tính năng ức chế lịch sử ở mức tốt nhất có thể cho Bash, Zsh và Fish. Các lệnh gọi MCP đến run_command sử dụng tính năng ức chế lệnh nhẹ theo mặc định. Khi bạn tạo một shell mới, hãy chọn các kiểm soát không ghi đĩa mạnh hơn với suppress_persistent_history=true.

[!note] Lời nhắc Tạo một tmux session có tên “checks” với các kiểm soát lịch sử shell không ghi đĩa ở mức tốt nhất, chạy pytest -q trong pane ban đầu của nó, và hiển thị cho tôi kết quả.

Tác nhân gọi create_session với suppress_persistent_history=true, tái sử dụng active_pane_id từ SessionInfo được trả về, và gọi run_command mà không có ghi đè. Tùy chọn spawn tương tự trên create_window, split_window, hoặc respawn_pane chỉ áp dụng cho tiến trình mà lệnh gọi đó khởi động.

Các kiểm soát này giảm nhiễu lịch sử; chúng không làm cho lệnh trở nên bí mật. Xem Ức chế lịch sử để biết hành vi cụ thể theo shell, Cấu hình để biết mặc định của máy chủ, và Mô hình tin cậy để biết các bề mặt quan sát khác.

Duyệt tất cả công cụ →

Mô hình tư duy

Hệ thống phân cấp đối tượng — sessions chứa windows, windows chứa panes (Khái niệm)
Bộ công cụ — inspect, manage, execute, teardown; những gì mỗi bộ nhóm lại (Mô hình tin cậy)
tmux là nguồn sự thật — máy chủ đọc từ nó và ghi vào nó, không bao giờ lưu cache hoặc trừu tượng hóa