libtmux-mcp server
resmilibtmux tarafından desteklenen tmux MCP sunucusu
Libtmux MCP ile neler yapabilirsiniz?
- tmux durumunu incele — Oturumları listelemesini iste, bölme çıktısını yakala veya belirli metin için bölmelerde arama yap.
- tmux yapısını yönet — Oturumları yeniden adlandır, bölmeleri yeniden boyutlandır, düzenleri seç veya pencereleri oturumlar arasında taşı.
- Bölmelerde komutları çalıştır — Oturumlar/pencereler oluştur, bölmeleri böl, tuş vuruşları gönder veya kabuk komutları çalıştır.
- Bölme süreçlerini kontrol et — Metin veya arabellekleri yapıştır, bölme çıktısını yönlendir veya ortam değişkenlerini ve seçenekleri ayarla.
- tmux nesnelerini kaldır — Bölme kaydırma geçmişini temizle, oturumları/pencereleri/bölmeleri sonlandır veya arabellekleri sil.
- Kabuk geçmişini bastır — Daha temiz test çalıştırmaları için disk geçmişi kontrolleri olmadan oturumlar veya pencereler oluştur.
Dokümantasyon
Terminal kontrolü, libtmux ve FastMCP üzerine inşa edilmiş yapay zeka ajanları için tasarlanmıştır.
Bu sunucu, tmux'un nesne hiyerarşisini — oturumlar, pencereler, bölmeler — istedikleri işleme göre gruplandırılmış MCP araçlarına eşler. Sunucu, seçilen grupları MCP araç sınırında zorunlu kılar.
[!warning] Uyarı Ön-alfa. API'ler değişebilir. Geri bildirim memnuniyetle karşılanır.
uvx kuruluysa:
$ claude mcp add tmux -- uvx libtmux-mcp
Hızlı başlangıç
Araçlar
İstemler
Kaynaklar
Güven modeli
İstemci kurulumu
Neler yapabilirsiniz
İnceleme incele
tmux durumunu ve terminal çıktısını isteyin.
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
Yönet yönet
tmux yapısını veya sunumunu değiştirin.
rename_session · resize_pane · select_layout · select_pane · move_window · enter_copy_mode · load_buffer · wait_for_channel
Yürüt yürüt
Bölme işlemlerini başlatın veya sürün, ya da daha sonraki yürütmeyi kontrol edebilecek durumu saklayın.
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
Yıkım yıkım
tmux nesnelerini veya saklanan kaydırma geçmişini silin. Geri alınamaz.
clear_pane · kill_session · kill_window · kill_pane · kill_server · delete_buffer
Örnek: test çalıştırmalarını kalıcı geçmişten uzak tutun
libtmux-mcp, Bash, Zsh ve Fish için en iyi çaba gösteren geçmiş bastırma sağlar. run_command yönelik MCP çağrıları varsayılan olarak hafif komut bastırma kullanır. Yeni bir kabuk oluşturduğunuzda, suppress_persistent_history=true ile daha güçlü disk dışı kontrollere geçin.
[!note] İstem "checks" adında bir tmux oturumu oluşturun, en iyi çaba gösteren disk dışı kabuk geçmişi kontrolleriyle, ilk bölmesinde
pytest -qçalıştırın ve sonucu bana gösterin.
Ajan, create_session öğesini suppress_persistent_history=true ile çağırır, döndürülen SessionInfo içinden active_pane_id öğesini yeniden kullanır ve run_command öğesini geçersiz kılma olmadan çağırır. create_window, split_window veya respawn_pane üzerindeki aynı başlatma seçeneği yalnızca o çağrının başlattığı işleme uygulanır.
Bu kontroller geçmiş gürültüsünü azaltır; komutları gizli yapmaz. Kabuğa özgü davranışlar için Geçmiş bastırma, sunucu varsayılanı için Yapılandırma ve diğer gözlem yüzeyleri için Güven modeli bölümlerine bakın.
Zihinsel model
- Nesne hiyerarşisi — oturumlar pencereleri, pencereler bölmeleri içerir (Kavramlar)
- Araç setleri — incele, yönet, yürüt, yıkım; her birinin grupladıkları (Güven modeli)
- tmux gerçeğin kaynağıdır — sunucu ondan okur ve ona yazar, asla önbelleğe almaz veya soyutlamaz