libtmux-mcp server

официальный

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

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

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

  • Проверить состояние tmux — Запросить read-only снимок сессий, окон или панелей через list_sessions, capture_pane или get_pane_info.
  • Выполнять команды в панелях — Позволить ассистенту выполнять shell-команды или отправлять нажатия клавиш с помощью run_command или send_keys, включая пакетные операции.
  • Управлять объектами tmux — Создавать, разделять, изменять размер или выбирать окна и панели с помощью таких инструментов, как create_window, split_window или select_pane.
  • Уничтожать ресурсы tmux — Завершать сессии, окна, панели или весь сервер с помощью разрушительных инструментов, таких как kill_session или kill_server.
  • Подавлять историю shell — Запускать сессии или окна с suppress_persistent_history=true, чтобы тестовые запуски не попадали в постоянную историю shell.

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

libtmux-mcp¶

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

Этот сервер отображает объектную иерархию tmux — сессии, окна, панели — в инструменты MCP. Некоторые инструменты читают состояние. Некоторые изменяют его. Некоторые уничтожают. Различие явное и enforced.

Предупреждение

Пре-альфа. API могут меняться. Отзывы приветствуются.

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

uvx pipx pip install

Настроить периоды охлаждения ?

Локальный пользовательский проект

Пользовательский проект

Пользовательский проект

Проект глобальный

Пользовательский проект

С установленным uvx:

$ claude mcp add tmux -- uvx libtmux-mcp

Назад

Периоды охлаждения зависимостей

Используйте флажок Настроить периоды охлаждения выше, чтобы включить или отключить. Эти настройки определяют поведение периодов охлаждения после включения.

Что такое периоды охлаждения?

Периоды охлаждения задерживают установку недавно загруженных пакетов, чтобы сообщество успело выявить атаки на цепочку поставок до вашей установки. Большинство менеджеров пакетов не применяют их по умолчанию — вы включаете их через глобальную настройку в конфигурации вашего инструмента.

Узнайте больше на cooldowns.dev · статья Datadog Security Labs.

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

Установите, подключитесь, получите первый результат. Менее 2 минут.

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

Инструменты

Каждый инструмент, сгруппированный по назначению и уровню безопасности.

Инструменты

Подсказки

Четыре рецепта рабочих процессов, которые клиент отображает для модели.

Подсказки

Ресурсы

Снимки иерархии tmux через URI tmux://.

Ресурсы

Уровни безопасности

Только чтение, изменение, уничтожение. Знайте, что меняет состояние.

Уровни безопасности

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

Блоки конфигурации для Claude Desktop, Claude Code, Cursor и других.

MCP-клиенты

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

Просмотр только для чтения¶

Чтение состояния tmux без каких-либо изменений.

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

Действия, изменяющие состояние¶

Создание или изменение объектов tmux.

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

Уничтожение (разрушительные действия)¶

Разрушение объектов tmux. Необратимо.

kill_session · kill_window · kill_pane · kill_server · call_destructive_tools_batch

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

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

Подсказка

Создайте tmux-сессию с именем «checks» с контролем истории оболочки без записи на диск (best-effort), выполните pytest -q в её начальной панели и покажите мне результат.

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

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

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

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

  • Объектная иерархия — сессии содержат окна, окна содержат панели (Concepts)
  • Чтение против изменения — некоторые инструменты наблюдают, некоторые действуют, некоторые уничтожают (Safety tiers)
  • tmux — источник истины — сервер читает из него и пишет в него, никогда не кэширует и не абстрагирует