libtmux-mcp server

resmi

libtmux tarafından desteklenen tmux MCP sunucusu

git-pull.com üzerinde görüntüleBu MCP'yi deneyinSponsorlu

Libtmux MCP ile neler yapabilirsiniz?

  • tmux durumunu incele — list_sessions, capture_pane veya get_pane_info ile oturumların, pencerelerin veya bölmelerin salt okunur bir anlık görüntüsünü isteyin.
  • Bölmelerde komut çalıştır — Asistanın run_command veya send_keys ile kabuk komutları yürütmesini veya tuş vuruşları göndermesini sağlayın, toplu işlemler dahil.
  • tmux nesnelerini yönet — create_window, split_window veya select_pane gibi araçları kullanarak pencereleri ve bölmeleri oluşturun, bölün, yeniden boyutlandırın veya seçin.
  • tmux kaynaklarını yok et — kill_session veya kill_server gibi yıkıcı araçlarla oturumları, pencereleri, bölmeleri veya tüm sunucuyu kapatın.
  • Kabuk geçmişini bastır — Test çalıştırmalarını kalıcı kabuk geçmişinden uzak tutmak için suppress_persistent_history=true ile oturumları veya pencereleri başlatın.

Dokümantasyon

libtmux-mcp¶

Terminal kontrolü, AI ajanları için; libtmux ve FastMCP üzerine inşa edilmiştir.

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

Uyarı

Ön-alfa. API’ler değişebilir. Geri bildirim memnuniyetle karşılanır.

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

uvx pipx pip install

Soğutma sürelerini yapılandır ?

Yerel Kullanıcı Projesi

Kullanıcı Projesi

Kullanıcı Projesi

Proje Global

Kullanıcı Projesi

uvx kurulu iken:

$ claude mcp add tmux -- uvx libtmux-mcp

Geri

Bağımlılık soğutma süreleri

Yukarıdaki Soğutma sürelerini yapılandır onay kutusunu kullanarak etkinleştirin veya devre dışı bırakın. Bu ayarlar, soğutma etkinleştirildiğinde nasıl davranacağını seçer.

Soğutma süreleri nedir?

Soğutma süreleri, yeni yüklenen paketleri almayı geciktirir; böylece topluluk, siz kurmadan önce tedarik zinciri saldırılarını fark 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 devre dışı bırakılmış olarak seçersiniz.

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

Quickstart

Kurun, bağlanın, ilk sonucu alın. 2 dakikanın altında.

Quickstart

Araçlar

Niyete ve güvenlik katmanına göre gruplandırılmış her araç.

Araçlar

İstemler

Model için istemcinin işlediği dört iş akışı tarifi.

İstemler

Kaynaklar

tmux:// URI’leri üzerinden tmux hiyerarşisinin anlık görünümleri.

Kaynaklar

Güvenlik katmanları

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

Güvenlik katmanları

İstemci kurulumu

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

MCP İstemcileri

Neler yapabilirsiniz¶

Salt okunur incele

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 · display_message · call_readonly_tools_batch

Değişiklik yapan eylemler

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ı silme

tmux nesnelerini yok edin. 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 elinden gelenin en iyisini yaparak geçmiş bastırma sağlar. run_command için 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ü disk-verme kontrollerini seçin.

Komut İstemi

"checks" adında bir tmux oturumu oluştur, elinden gelenin en iyisiyle disk-dışı kabuk geçmişi kontrolleriyle, ilk bölmesinde pytest -q çalıştır ve sonucu bana göster.

Ajan, create_session ile birlikte suppress_persistent_history=true çağırır, dönen SessionInfo içinden active_pane_id yeniden kullanır ve bir geçersiz kılma olmadan run_command çağırır. create_window, split_window veya respawn_pane üzerindeki aynı oluşturma 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. Kabuk özel davranışı için Geçmiş bastırma, sunucu varsayılanı için Yapılandırma ve diğer gözlem yüzeyleri için Güvenlik katmanları bölümüne bakın.

Tüm araçlara göz at →

Zihinsel model¶

  • Nesne hiyerarşisi — oturumlar pencereleri içerir, pencereler bölmeleri içerir (Kavramlar)
  • Okuma vs. değiştirme — bazı araçlar gözlemler, bazıları eylem yapar, bazıları yok eder (Güvenlik katmanları)
  • tmux gerçeğin kaynağıdır — sunucu ondan okur ve ona yazar, asla önbelleğe almaz veya soyutlamaz