Tmux MCP Server — доступ агента к сессиям tmux
Tmux MCP Server
MCP-сервер, через который агент читает панели tmux, запускает в них команды и создает сессии, а вы видите вывод
- 305 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Инструмент execute-command запускает произвольные команды в панели tmux с правами вашего пользователя
- Агент может закрывать сессии, окна и панели, прерывая запущенные там процессы
- Захват панелей показывает все, что напечатано в терминале, включая секреты и токены
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/tmux-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструмент execute-command запускает произвольные команды в панели tmux с правами вашего пользователя
- Агент может закрывать сессии, окна и панели, прерывая запущенные там процессы
- Захват панелей показывает все, что напечатано в терминале, включая секреты и токены
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Tmux MCP Server соединяет агента с уже запущенным tmux. Агент видит список сессий, окон и панелей, находит сессию по имени и снимает текст с любой панели. Так он читает вывод долгих процессов, логи сервера или идущих тестов, и вам не нужно копировать их вручную. Кроме чтения сервер умеет управлять. Инструмент `execute-command` запускает команду в выбранной панели, а `get-command-result` возвращает ее результат по идентификатору. Агент может создавать сессии и окна, делить панель по горизонтали или вертикали с заданным размером и закрывать сессии, окна и панели. Те же данные сервер отдает и как три ресурса MCP: список сессий, содержимое панели и итог команды.
Для кого. Для разработчиков, которые держат серверы, сборки и логи в tmux и хотят, чтобы агент видел их и мог запускать команды в тех же окнах.
Подходит, если
- В одной панели идет сборка или тесты, и агент должен прочитать ошибки без ручного копирования
- Нужно, чтобы агент запустил команду в уже открытой сессии и показал результат
- Для задачи нужно разложить окружение: создать сессию, разделить окно на панели и запустить в них сервер и клиент
- Хотите вручную смотреть в терминал, пока агент работает в той же панели
- Нужно найти сессию по имени среди нескольких запущенных
Не подходит, если
- Нужно только запустить одну команду: агентам для этого хватает собственного терминала
- В среде нет tmux или он не запущен: серверу нужен работающий tmux
- В сессиях открыты продакшен-серверы или привилегированные оболочки, куда агент не должен попадать
- Работаете без присмотра: инструмент закрывает сессии и выполняет любые команды
Пример запроса к агенту
Посмотри панель с тестами в сессии `dev`, найди упавший тест и скажи, в чем ошибка.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Требуются Node.js и установленный запущенный tmux. Оболочку сервер учитывает только при запуске команд, по ней он читает код завершения. Если вы работаете в fish, укажите --shell-type, иначе подразумевается bash.
Запуск команд автор прямо оставляет под вашу ответственность: подтверждения на стороне сервера нет. Снимок панели передает агенту все, что напечатано в терминале. Последнее обновление репозитория вышло в феврале 2026 года.
Как отключить. Удалите запись tmux из блока mcpServers в конфигурации клиента и перезапустите его. Запущенные сессии tmux остаются как были.
Частые вопросы
Как подключить Tmux MCP Server?
Добавьте в блок mcpServers конфигурации клиента запись tmux с командой npx и аргументами -y и tmux-mcp, затем перезапустите клиент. Отдельной установки и ключей не требуется, нужен лишь запущенный tmux.
Какие инструменты есть у сервера?
Тринадцать: `list-sessions`, `find-session`, `list-windows`, `list-panes`, `capture-pane`, `create-session`, `create-window`, `split-pane`, `kill-session`, `kill-window`, `kill-pane`, `execute-command` и `get-command-result`.
Зачем нужен аргумент --shell-type?
Сервер использует оболочку, когда запускает команду в панели, чтобы правильно прочитать код завершения. По умолчанию это bash, для fish значение задают явно.
Безопасно ли разрешать агенту `execute-command`?
Инструмент запускает любые команды в выбранной панели с правами вашего пользователя. Подтверждайте вызовы вручную и не держите в этих сессиях привилегированные оболочки.
Какие ресурсы MCP отдает сервер?
Три: `tmux://sessions` со списком сессий, `tmux://pane/{paneId}` с содержимым панели и `tmux://command/{commandId}/result` с результатом команды.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыSSH MCP Server (classfang) — команды на сервере по SSH
SSH MCP Server (classfang)
MCP-сервер для SSH: агент выполняет команды, читает и пишет файлы по SFTP, передает файлы и запускает долгие задачи, а пароли остаются у вас
Защищенный MCP-рантайм, через который агент управляет локальными машинами, серверами и контейнерами
Самостоятельно размещаемый MCP-сервер для выполнения команд на удаленных серверах по SSH с токенами и ролями
Самостоятельно размещаемый шлюз, который собирает несколько MCP-серверов в один эндпоинт с авторизацией и выбором инструментов
Менеджер MCP-серверов на Node.js: запускает локальные и подключает удаленные серверы и отдает их клиенту одним адресом с REST API для управления
MCP SSH Manager
mcp-ssh-manager
Управление несколькими SSH-подключениями из Claude Code и Codex: команды, перенос файлов, базы данных и бэкапы. Стабильная ветка в npm, в GitHub бета 4.0
Коротко о README
Страница короткая: возможности, требования и пример настройки для Claude Desktop, затем ресурсы и список инструментов. К описанию приложено видео с демонстрацией работы.