libtmux-mcp server

libtmux-mcp¶

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

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

พรอมต์

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

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

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

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

---

แบบจำลองความคิด¶

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

---