libtmux-mcp server

offiziell

Von libtmux betriebener tmux MCP-Server

Auf git-pull.com ansehenDieses MCP ausprobierenGesponsert

Was kann man mit Libtmux MCP machen?

  • tmux-Status prüfen — Sitzungen auflisten, Pane-Ausgabe erfassen oder Panes nach bestimmtem Text durchsuchen.
  • tmux-Struktur verwalten — Sitzungen umbenennen, Panes skalieren, Layouts auswählen oder Fenster zwischen Sitzungen verschieben.
  • Befehle in Panes ausführen — Sitzungen/Fenster erstellen, Panes teilen, Tastatureingaben senden oder Shell-Befehle ausführen.
  • Pane-Prozesse steuern — Text oder Puffer einfügen, Pane-Ausgabe weiterleiten oder Umgebungsvariablen und Optionen setzen.
  • tmux-Objekte abbauen — Pane-Scrollback leeren, Sitzungen/Fenster/Panes beenden oder Puffer löschen.
  • Shell-Verlauf unterdrücken — Sitzungen oder Fenster mit No-Disk-Verlaufskontrolle für sauberere Testläufe erstellen.

Dokumentation

Terminalsteuerung für KI-Agenten, basierend auf libtmux und FastMCP.

Dieser Server bildet die Objekthierarchie von tmux – Sessions, Fenster, Panes – auf MCP-Tools ab, die nach der von ihnen angeforderten Operation gruppiert sind. Der Server erzwingt die ausgewählten Gruppen an der MCP-Tool-Grenze.

[!warning] Warnung Vor-Alpha. APIs können sich ändern. Feedback willkommen.

Mit installiertem uvx:

$ claude mcp add tmux -- uvx libtmux-mcp

Schnellstart

Schnellstart

Tools

Tools

Prompts

Prompts

Ressourcen

Ressourcen

Vertrauensmodell

Vertrauensmodell

Client-Einrichtung

MCP-Clients

Was Sie tun können

Untersuchen untersuchen

tmux-Zustand und Terminalausgabe anfordern.

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

Verwalten verwalten

tmux-Struktur oder -Darstellung ändern.

rename_session · resize_pane · select_layout · select_pane · move_window · enter_copy_mode · load_buffer · wait_for_channel

Ausführen ausführen

Pane-Prozesse starten oder steuern oder Zustand speichern, der spätere Ausführungen steuern kann.

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

Abbau abbau

tmux-Objekte oder gespeicherten Scrollback löschen. Nicht umkehrbar.

clear_pane · kill_session · kill_window · kill_pane · kill_server · delete_buffer

Beispiel: Testläufe aus dem persistenten Verlauf heraushalten

libtmux-mcp bietet Best-Effort-Verlaufsunterdrückung für Bash, Zsh und Fish. MCP-Aufrufe an run_command verwenden standardmäßig eine leichtgewichtige Befehlsunterdrückung. Wenn Sie eine neue Shell erstellen, können Sie mit suppress_persistent_history=true stärkere No-Disk-Kontrollen aktivieren.

[!note] Prompt Erstellen Sie eine tmux-Session namens „checks“ mit Best-Effort-No-Disk-Shell-Verlaufskontrollen, führen Sie pytest -q im anfänglichen Pane aus und zeigen Sie mir das Ergebnis.

Der Agent ruft create_session mit suppress_persistent_history=true auf, verwendet active_pane_id aus dem zurückgegebenen SessionInfo erneut und ruft run_command ohne Überschreibung auf. Dieselbe Spawn-Option bei create_window, split_window oder respawn_pane gilt nur für den Prozess, den dieser Aufruf startet.

Diese Kontrollen reduzieren Verlaufsrauschen; sie machen Befehle nicht geheim. Siehe Verlaufsunterdrückung für shell-spezifisches Verhalten, Konfiguration für den Serverstandard und Vertrauensmodell für andere Beobachtungsoberflächen.

Alle Tools durchsuchen →

Mentales Modell

  • Objekthierarchie – Sessions enthalten Fenster, Fenster enthalten Panes (Konzepte)
  • Toolsets – untersuchen, verwalten, ausführen, abbauen; was jedes gruppiert (Vertrauensmodell)
  • tmux ist die Quelle der Wahrheit – der Server liest daraus und schreibt hinein, cached oder abstrahiert nie