libtmux-mcp server

libtmux-mcp¶

Đ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 — phiên, cửa sổ, khung — thành các công cụ MCP. Một số công cụ đọc trạng thái. Một số thay đổi nó. Một số phá hủy. Sự khác biệt là rõ ràng và được thực thi.

Cảnh báo

Tiền alpha. API có thể thay đổi. Phản hồi được hoan nghênh.

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

uvx pipx pip install

Cấu hình thời gian chờ ?

Cục bộ Người dùng Dự án

Người dùng Dự án

Người dùng Dự án

Dự án Toàn cầu

Người dùng Dự án

Người dùng Dự án

Dự án Toàn cầu

Người dùng Dự án

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

$ claude mcp add tmux -- uvx libtmux-mcp

Quay lại

Thời gian chờ phụ thuộc

Sử dụng hộp kiểm Cấu hình thời gian chờ ở trên để bật hoặc tắt. Các cài đặt này chọn cách thời gian chờ hoạt động khi được bật.

Thời gian chờ là gì?

Thời gian chờ trì hoãn việc nhận các gói mới tải lên để cộng đồng có thời gian phát hiện các cuộc tấn công chuỗi cung ứng trước khi bạn cài đặt. Hầu hết các trình quản lý gói không áp dụng mặc định — bạn chọn tham gia thông qua cài đặt toàn cục trong cấu hình công cụ của mình.

Tìm hiểu thêm tại cooldowns.dev · Bài viết của Datadog Security Labs.

---

Bắt đầu nhanh

Cài đặt, kết nối, nhận kết quả đầu tiên. Dưới 2 phút.

Bắt đầu nhanh

Công cụ

Mọi công cụ, được nhóm theo mục đích và mức độ an toàn.

Công cụ

Lời nhắc

Bốn công thức quy trình làm việc mà client hiển thị cho mô hình.

Lời nhắc

Tài nguyên

Chế độ xem ảnh chụp nhanh của hệ thống phân cấp tmux qua tmux:// URIs.

Tài nguyên

Mức an toàn

Chỉ đọc, thay đổi, phá hủy. Biết cái gì thay đổi trạng thái.

Mức an toàn

Thiết lập client

Các khối cấu hình cho Claude Desktop, Claude Code, Cursor và các client khác.

MCP Clients

---

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

Kiểm tra chỉ đọc¶

Đọc trạng thái tmux mà không thay đổi bất cứ điều gì.

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

Hành động thay đổi¶

Tạo hoặc sửa đổi các đối tượng 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

Phá hủy¶

Phá hủy các đối tượng tmux. Không thể đảo ngược.

kill_session · kill_window · kill_pane · kill_server · call_destructive_tools_batch

Ví dụ: giữ các lần chạy kiểm tra khỏi lịch sử vĩnh viễn¶

libtmux-mcp cung cấp việc ngăn chặn lịch sử theo khả năng tốt nhất cho Bash, Zsh và Fish. Các cuộc gọi MCP đến run_command sử dụng ngăn chặn lệnh nhẹ theo mặc định. Khi bạn tạo shell mới, hãy chọn các điều khiển không đĩa mạnh hơn vớisuppress_persistent_history=true.

Lời nhắc

Tạo một phiên tmux có tên "checks" với các điều khiển lịch sử shell không đĩa theo khả năng tốt nhất, chạy pytest -q trong khung ban đầu của nó, và hiển thị cho tôi kết quả.

Đại lý gọi create_session vớisuppress_persistent_history=true, tái sử dụng active_pane_id từ SessionInfo trả về, và gọirun_command mà không có ghi đè. Tùy chọn sinh môi trường tương tự trêncreate_window, split_window, hoặcrespawn_pane chỉ áp dụng cho tiến trình mà lệnh gọi đó bắt đầu.

Các điều khiển này giảm tiếng ồn lịch sử; chúng không làm cho lệnh trở nên bí mật. Xem Ngăn chặn lịch sử để biết hành vi cụ thể theo shell, Cấu hình để biết mặc định máy chủ, và Mức an toàn cho các bề mặt quan sát khác.

Xem tất cả công cụ →

---

Mô hình tư duy¶

• Hệ thống phân cấp đối tượng — phiên chứa cửa sổ, cửa sổ chứa khung (Khái niệm)
• Đọc vs. thay đổi — một số công cụ quan sát, một số hành động, một số phá hủy (Mức an toàn)
• 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

---