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

Cảnh báo

Tiền alpha. API có thể thay đổi. Hoan nghênh phản hồi.

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

uvx pipx pip install

Định 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ục

Người dùng Dự án

Với uvx đã được 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 Định 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 sau khi được bật.

Thời gian chờ là gì?

Thời gian chờ trì hoãn việc tải xuống 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 thời gian chờ theo 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 · Datadog Security Labs writeup.

---

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à cấp độ an toàn.

Công cụ

Lời nhắc

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

Lời nhắc

Tài nguyên

Chế độ xem nhanh của hệ thống phân cấp tmux qua các URI tmux://.

Tài nguyên

Cấp độ an toàn

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

Cấp độ an toàn

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

Khối cấu hình cho Claude Desktop, Claude Code, Cursor và các ứng dụng khác.

Máy khách MCP

---

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 · wait_for_content_change · 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

Hủy diệt phá hủy¶

Phá bỏ 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 thử nghiệm khỏi lịch sử liên tục¶

libtmux-mcp cung cấp khả năng ức chế lịch sử nỗ lực tốt nhất cho Bash, Zsh và Fish. Các lệnh gọi MCP đến run_command sử dụng ức chế lệnh nhẹ theo mặc định. Khi bạn tạo một shell mới, hãy chọn tham gia các điều khiển không ghi đĩa mạnh mẽ hơn với suppress_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 ghi đĩa nỗ lực tốt nhất, chạy pytest -q trong ngăn 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 đó bắt đầu.

Các điều khiển này giảm nhiễu lịch sử; chúng không làm cho các lệnh trở nên bí mật. Xem Ức chế lịch sử để biết hành vi cụ thể của shell, Cấu hình để biết mặc định của máy chủ, và Cấp độ an toàn để 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 — phiên chứa cửa sổ, cửa sổ chứa ngăn (Khái niệm)
• Đọc so với thay đổi — một số công cụ quan sát, một số hành động, một số hủy diệt (Cấp độ 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 trữ đệm hoặc trừu tượng hóa

---