libtmux-mcp server

resmi

libtmux tarafından desteklenen tmux MCP sunucusu

git-pull.com üzerinde görüntüle

Libtmux MCP ile neler yapabilirsiniz?

  • tmux durumunu incele — list_sessions, capture_pane, get_pane_info veya search_panes ile oturum, pencere ve bölme ayrıntılarını okuyun.
  • Bölmelere girdi gönder — send_keys, send_keys_batch, run_command veya paste_text kullanarak hedef bölmeye komut veya metin yazın.
  • Oturumlar oluştur ve düzenle — create_session, create_window ve split_window ile adlandırılmış oturumlar, pencereler ve bölünmüş bölmeler oluşturun.
  • tmux nesnelerini yok et — kill_session, kill_window, kill_pane veya kill_server ile oturumları, pencereleri, bölmeleri veya tüm sunucuyu kapatın.
  • Kabuk geçmişini bastır — Test çalıştırmalarını ve tek seferlik komutları kalıcı kabuk geçmişinin dışında tutmak için suppress_persistent_history ile bölmeler başlatın.

Dokümantasyon

libtmux-mcp¶

libtmux ve FastMCP üzerine inşa edilmiş, yapay zeka ajanları için terminal kontrolü.

Bu sunucu, tmux'un nesne hiyerarşisini — oturumlar, pencereler, paneller — MCP araçlarına eşler. Bazı araçlar durumu okur. Bazıları değiştirir. Bazıları yok eder. Ayrım açık ve zorunludur.

Uyarı

Alfa öncesi. API'ler değişebilir. Geri bildirimlere açığız.

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

uvx pipx pip install

Bekleme sürelerini yapılandır ?

Yerel Kullanıcı Proje

Kullanıcı Proje

Kullanıcı Proje

Proje Genel

Kullanıcı Proje

uvx kurulu iken:

$ claude mcp add tmux -- uvx libtmux-mcp

Geri

Bağımlılık bekleme süreleri

Etkinleştirmek veya devre dışı bırakmak için yukarıdaki Bekleme sürelerini yapılandır onay kutusunu kullanın. Bu ayarlar, etkinleştirildikten sonra bekleme süresinin nasıl davranacağını seçer.

Bekleme süreleri nedir?

Bekleme süreleri, yeni yüklenen paketlerin alınmasını geciktirir, böylece topluluk siz kurmadan önce tedarik zinciri saldırılarını tespit etme şansına sahip olur. Çoğu paket yöneticisi varsayılan olarak bir tane uygulamaz — aracınızın yapılandırmasındaki genel bir ayar aracılığıyla dahil olursunuz.

Daha fazla bilgi için cooldowns.dev · Datadog Security Labs yazısı.

Hızlı Başlangıç

Kurun, bağlanın, ilk sonucu alın. 2 dakikadan az.

Hızlı Başlangıç

Araçlar

Her araç, amaca ve güvenlik seviyesine göre gruplandırılmıştır.

Araçlar

İstemler

İstemcinin model için işlediği dört iş akışı tarifi.

İstemler

Kaynaklar

tmux:// URI'leri aracılığıyla tmux hiyerarşisinin anlık görüntü görünümleri.

Kaynaklar

Güvenlik seviyeleri

Salt okunur, değiştiren, yıkıcı. Neyin durumu değiştirdiğini bilin.

Güvenlik seviyeleri

İstemci kurulumu

Claude Desktop, Claude Code, Cursor ve diğerleri için yapılandırma blokları.

MCP İstemcileri

Neler yapabilirsiniz¶

Salt okunur inceleme¶

Hiçbir şeyi değiştirmeden tmux durumunu okuyun.

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

Değiştiren eylem¶

tmux nesneleri oluşturun veya değiştirin.

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

Yıkıcı yok etme¶

tmux nesnelerini parçalayın. Geri alınamaz.

kill_session · kill_window · kill_pane · kill_server · call_destructive_tools_batch

Örnek: test çalıştırmalarını kalıcı geçmişten uzak tutun¶

libtmux-mcp, Bash, Zsh ve Fish için en iyi çabayla geçmiş bastırma sağlar. run_command'e yapılan 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ü disksiz kontrollere geçin.

İstem

"checks" adında, en iyi çabayla disksiz kabuk geçmişi kontrollerine sahip bir tmux oturumu oluşturun, ilk panelinde pytest -q'ü çalıştırın ve sonucu bana gösterin.

Ajan,suppress_persistent_history=true ile create_session'ü çağırır, dönenSessionInfo'den active_pane_id'ü yeniden kullanır ve bir geçersiz kılma olmadanrun_command'i çağırır. create_window, split_window veyarespawn_pane üzerindeki aynı spawn seçeneği yalnızca o çağrının başlattığı süreç için geçerlidir.

Bu kontroller geçmiş gürültüsünü azaltır; komutları gizli yapmazlar. Kabuğa özgü davranış içinGeçmiş bastırma, sunucu varsayılanı içinYapılandırma ve diğer gözlem yüzeyleri için Güvenlik seviyeleri bölümlerine bakın.

Tüm araçlara göz atın →

Zihinsel model¶

  • Nesne hiyerarşisi — oturumlar pencereleri, pencereler panelleri içerir (Kavramlar)
  • Oku vs. değiştir — bazı araçlar gözlemler, bazıları eylemde bulunur, bazıları yok eder (Güvenlik seviyeleri)
  • tmux doğruluk kaynağıdır — sunucu ondan okur ve ona yazar, asla önbelleğe almaz veya soyutlamaz