libtmux-mcp server

официальный

MCP-сервер tmux на базе libtmux

Смотреть на git-pull.comПопробовать этот MCPСпонсировано

Что можно делать с Libtmux MCP?

Проверить состояние tmux — Запросить список сессий, захватить вывод панели или выполнить поиск по панелям для конкретного текста.
Управлять структурой tmux — Переименовывать сессии, изменять размер панелей, выбирать макеты или перемещать окна между сессиями.
Выполнять команды в панелях — Создавать сессии/окна, разделять панели, отправлять нажатия клавиш или запускать команды оболочки.
Управлять процессами панелей — Вставлять текст или буферы, перенаправлять вывод панели или задавать переменные окружения и параметры.
Удалять объекты tmux — Очищать прокрутку панели, завершать сессии/окна/панели или удалять буферы.
Подавлять историю оболочки — Создавать сессии или окна с контролем истории без записи на диск для более чистых тестовых запусков.

Документация

Управление терминалом для ИИ-агентов, построенное на libtmux и FastMCP.

Этот сервер сопоставляет объектную иерархию tmux — сессии, окна, панели — с инструментами MCP, сгруппированными по запрашиваемой операции. Сервер применяет выбранные группы на границе инструментов MCP.

[!warning] Предупреждение Пре-альфа. API могут меняться. Обратная связь приветствуется.

При установленном uvx:

$ claude mcp add tmux -- uvx libtmux-mcp

Быстрый старт

Инструменты

Промпты

Ресурсы

Модель доверия

Настройка клиента

MCP-клиенты

Что вы можете делать

Проверка inspect

Запрос состояния tmux и вывода терминала.

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

Управление manage

Изменение структуры или представления tmux.

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

Выполнение execute

Запуск или управление процессами в панелях, либо сохранение состояния, которое может управлять последующим выполнением.

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

Удаление teardown

Удаление объектов tmux или сохранённой прокрутки. Необратимо.

clear_pane · kill_session · kill_window · kill_pane · kill_server · delete_buffer

Пример: держать тестовые запуски вне постоянной истории

libtmux-mcp предоставляет подавление истории с максимальными усилиями для Bash, Zsh и Fish. MCP-вызовы run_command по умолчанию используют лёгкое подавление команд. При создании новой оболочки выберите более строгие параметры без записи на диск с помощью suppress_persistent_history=true.

[!note] Промпт Создайте tmux-сессию с именем «checks» с параметрами подавления истории оболочки без записи на диск с максимальными усилиями, запустите pytest -q в её начальной панели и покажите мне результат.

Агент вызывает create_session с suppress_persistent_history=true, повторно использует active_pane_id из возвращённого SessionInfo и вызывает run_command без переопределения. Тот же параметр запуска в create_window, split_window или respawn_pane применяется только к процессу, который запускает этот вызов.

Эти параметры уменьшают шум в истории; они не делают команды секретными. См. Подавление истории для поведения, специфичного для оболочек, Конфигурация для значения по умолчанию сервера и Модель доверия для других поверхностей наблюдения.

Просмотреть все инструменты →

Ментальная модель

Объектная иерархия — сессии содержат окна, окна содержат панели (Концепции)
Наборы инструментов — проверка, управление, выполнение, удаление; что каждый группирует (Модель доверия)
tmux — источник истины — сервер читает из него и записывает в него, никогда не кэширует и не абстрагирует