libtmux-mcp server

libtmux-mcp¶

ควบคุมเทอร์มินัลสำหรับเอเจนต์ AI สร้างขึ้นบน libtmux และ FastMCP

เซิร์ฟเวอร์นี้แมปลำดับชั้นของออบเจกต์ tmux — sessions, windows, panes — เป็นเครื่องมือ MCP เครื่องมือบางส่วนอ่านสถานะ บางส่วนเปลี่ยนแปลง และบางส่วนทำลาย ความแตกต่างนี้ชัดเจนและบังคับใช้

คำเตือน

ก่อนเวอร์ชันอัลฟ่า API อาจเปลี่ยนแปลงได้ ยินดีรับฟังความคิดเห็น

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

uvx pipx pip install

กำหนดค่า cooldowns ?

Local User Project

User Project

User Project

Project Global

User Project

เมื่อติดตั้ง uvx แล้ว:

$ claude mcp add tmux -- uvx libtmux-mcp

กลับ

การหน่วงเวลาการพึ่งพา (Dependency cooldowns)

ใช้ช่องทำเครื่องหมาย Configure cooldowns ด้านบนเพื่อเปิดหรือปิดใช้งาน การตั้งค่าเหล่านี้จะเลือกวิธีการทำงานของ cooldown เมื่อเปิดใช้งานแล้ว

cooldowns คืออะไร?

cooldowns ชะลอการรับแพ็คเกจที่อัปโหลดใหม่ เพื่อให้ชุมชนมีเวลาตรวจสอบการโจมตีห่วงโซ่อุปทานก่อนที่คุณจะติดตั้ง ตัวจัดการแพ็คเกจส่วนใหญ่ไม่ได้ใช้ค่านี้เป็นค่าเริ่มต้น — คุณเลือกใช้ผ่านการตั้งค่าระดับโลกในการกำหนดค่าเครื่องมือของคุณ

เรียนรู้เพิ่มเติมที่ cooldowns.dev · บทความของ Datadog Security Labs

---

เริ่มต้นใช้งาน

ติดตั้ง เชื่อมต่อ รับผลลัพธ์แรก ใช้เวลาไม่ถึง 2 นาที

เริ่มต้นใช้งาน

เครื่องมือ

ทุกเครื่องมือ จัดกลุ่มตามวัตถุประสงค์และระดับความปลอดภัย

เครื่องมือ

พรอมต์

สูตรเวิร์กโฟลว์สี่แบบที่ไคลเอ็นต์แสดงให้โมเดลดู

พรอมต์

ทรัพยากร

มุมมองสแนปชอตของลำดับชั้น tmux ผ่าน URI tmux://

ทรัพยากร

ระดับความปลอดภัย

อ่านอย่างเดียว เปลี่ยนแปลง และทำลาย รู้ว่าสิ่งใดเปลี่ยนสถานะ

ระดับความปลอดภัย

การตั้งค่าไคลเอ็นต์

บล็อกการกำหนดค่าสำหรับ Claude Desktop, Claude Code, Cursor และอื่นๆ

ไคลเอ็นต์ MCP

---

สิ่งที่คุณทำได้¶

ตรวจสอบแบบอ่านอย่างเดียว (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 มีการระงับประวัติแบบ best-effort สำหรับ Bash, Zsh และ Fish การเรียก MCP ไปที่ run_command ใช้การระงับคำสั่งแบบน้ำหนักเบาเป็นค่าเริ่มต้น เมื่อคุณสร้าง shell ใหม่ ให้เลือกใช้การควบคุมแบบไม่มีดิสก์ที่แข็งแกร่งยิ่งขึ้นด้วย suppress_persistent_history=true

พรอมต์

สร้างเซสชัน tmux ชื่อ “checks” พร้อมการควบคุมประวัติ shell แบบ best-effort ที่ไม่บันทึกลงดิสก์ รัน pytest -q ใน pane เริ่มต้น และแสดงผลลัพธ์ให้ฉันดู

เอเจนต์เรียก create_session ด้วย suppress_persistent_history=true ใช้ active_pane_id ซ้ำจาก SessionInfo ที่ส่งคืนมา และเรียก run_command โดยไม่มีการแทนที่ ตัวเลือก spawn เดียวกันบน create_window, split_window หรือ respawn_pane จะใช้กับกระบวนการที่การเรียกนั้นเริ่มต้นเท่านั้น

การควบคุมเหล่านี้ช่วยลดสัญญาณรบกวนในประวัติ ไม่ได้ทำให้คำสั่งเป็นความลับ ดู History suppression สำหรับพฤติกรรมเฉพาะของ shell, Configuration สำหรับค่าเริ่มต้นของเซิร์ฟเวอร์ และ Safety tiers สำหรับพื้นผิวการสังเกตอื่นๆ

เรียกดูเครื่องมือทั้งหมด →

---

แบบจำลองทางความคิด (Mental model)¶

• ลำดับชั้นของออบเจกต์ — sessions มี windows, windows มี panes (แนวคิด)
• อ่าน vs. เปลี่ยนแปลง — เครื่องมือบางอย่างสังเกตการณ์ บางอย่างดำเนินการ บางอย่างทำลาย (ระดับความปลอดภัย)
• tmux คือแหล่งข้อมูลที่เชื่อถือได้ — เซิร์ฟเวอร์อ่านจากและเขียนไปยัง tmux ไม่เคยแคชหรือสร้างนามธรรม

---