pty-mcp — MCP-сервер для Claude Code: интерактивные терминалы и SSH
MCP-сервер, который даёт агенту интерактивные терминальные сессии: локальный shell, SSH, серийные порты и удалённые сессии, которые не рвутся при отключении.
Открыть на GitHubЧто делает pty-mcp
Агент получает инструменты create_local_session, create_ssh_session, create_serial_session, send_input, read_output и wait_for. Можно подключиться к серверу по SSH и отправлять команды, ждать события в логе (сервер блокирует вызов, пока не найдёт паттерн в выводе — вместо опроса в цикле), подключиться к роутеру через /dev/ttyUSB0 или запустить apt upgrade и отсоединиться — сессия продолжится на удалённом хосте через демон ai-tmux.
Сервер написан на Go, бинарник весит несколько мегабайт, работает на macOS, Linux и WSL2. Для персистентных удалённых сессий нужно поставить ai-tmux на целевой хост (скрипт install.sh или ручное копирование бинарника). Серийный порт требует права на устройство. Аудит-лог (опционально) записывает команды в коллектор, вырезая учётные данные перед записью.
Какие задачи решает
- Подключиться к серверу по SSH и запустить интерактивную команду
- Следить за логом и отреагировать, когда появится строка ERROR
- Подключиться к роутеру или свичу через серийный порт
- Запустить длинную задачу на удалённом хосте и отсоединиться до завершения
- Перезагрузить сервер и дождаться, когда он снова ответит на ping
Примеры запросов агенту
- Подключись по SSH к
prod.example.comпод пользователемadminи выполниsystemctl status nginx - Открой локальный терминал, запусти
tail -f /var/log/app.logи жди строку сCRITICAL - Подключись к
/dev/ttyUSB0на скорости 9600 и отправь командуshow interfaces
Как установить pty-mcp
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о pty-mcp
Как установить pty-mcp в Claude Code?
Выполни claude plugin marketplace add raychao-oao/pty-mcp, затем claude plugin install pty-mcp@pty-mcp и перезапусти Claude Code дважды — первый раз бинарник скачается, второй раз сервер активируется.
Что делает pty-mcp?
Даёт агенту интерактивные терминальные сессии: локальный shell, SSH, серийные порты и удалённые сессии, которые продолжаются после отключения. Агент может подключиться к серверу, отправлять команды, ждать события в выводе и управлять долгими задачами.
Нужно ли что-то ставить на удалённый хост?
Для персистентных сессий (тех, что не рвутся при отключении SSH) нужно поставить демон ai-tmux на удалённый сервер. Для обычных SSH-сессий ничего дополнительно не требуется.
