MCP server ssh-tmux
Коммит 3 окт. 2026 г.Управляет постоянными SSH-сессиями через tmux, позволяя AI-агентам взаимодействовать с удаленными терминалами с помощью визуальных снимков экрана.
Также известен как devnullvoid/mcp-ssh-tmux
- Звёзды
- 7
- Инструменты
- 9
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 3 окт. 2026 г.
- Лицензия
- MIT
Что такое ssh-tmux MCP?
ssh-tmux — это MCP server. Управляет постоянными SSH-сессиями через tmux, позволяя AI-агентам взаимодействовать с удаленными терминалами с помощью визуальных снимков экрана. Он предоставляет 9 инструментов, например open_session, send_command, send_keys.
Сводка сгенерирована из README проекта
О ssh-tmux MCP server
Этот сервер позволяет разработчикам, использующим AI-агентов, управлять постоянными сессиями удаленного терминала через визуальные снимки экрана. Используя локальный экземпляр tmux в качестве мультиплексора терминалов, сервер дает агенту возможность взаимодействовать с удаленными машинами так, будто это человек, смотрящий на экран. Такой подход избавляет от необходимости использовать сложные регулярные выражения для определения завершения команд, так как агент интерпретирует приглашения и ошибки напрямую из вывода терминала.
Пользователи могут настроить это локально через uv или pip и подключить к таким клиентам, как Claude Desktop или Cursor. Сервер поддерживает SSH-соединения в выделенных окнах tmux, а это значит, что сессии остаются активными, даже если клиент или MCP server перезагрузятся. Он использует ssh -G для надежного разрешения конфигурации и работает через изолированный сокет tmux с именем mcp-ssh, чтобы не мешать пользовательским сессиям. Инструментарий включает функции для открытия сессий, отправки команд или необработанных нажатий клавиш, создания снимков экрана и выполнения удаленной передачи файлов с помощью специальных инструментов чтения и записи.
Что вы можете с ним делать
- 1Мониторинг длительных удаленных процессовAI-агент может проверять прогресс фоновой сборки или загрузки, не прерывая задачу.
- 2Выполнение удаленных операций с файламиРазработчик может поручить агенту прочитать или изменить конфигурационные файлы на удаленном сервере.
- 3Ручная проверка активности агентаПользователь может подключиться к конкретному сокету tmux, чтобы наблюдать за работой агента в терминале в режиме реального времени.
- 4Обработка интерактивного ввода в терминалеАгент может отправлять специфические нажатия клавиш, такие как Ctrl+C, для управления запущенными процессами.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Инструменты ssh-tmux MCP 9
Определено из READMEopen_sessionsend_commandsend_keysget_snapshotread_remote_filewrite_remote_filelist_sessionscleanup_dead_sessionsclose_session
| open_session | — | |
| send_command | — | |
| send_keys | — | |
| get_snapshot | — | |
| read_remote_file | — | |
| write_remote_file | — | |
| list_sessions | — | |
| cleanup_dead_sessions | — | |
| close_session | — |
Конфигурация
FASTMCP_TRANSPORT
| Название | Описание | Тип |
|---|---|---|
| FASTMCP_TRANSPORT | — |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийdevnullvoid/mcp-ssh-tmux is public and reachablegithub.com/devnullvoid/mcp-ssh-tmux ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-10-03github.com/devnullvoid/mcp-ssh-tmux ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели9 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыNo tool named like delete, drop or execПройдено
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на GitHubmcp-ssh-tmux
A high-performance, persistent Model Context Protocol (MCP) server that manages SSH sessions via a local tmux instance.
Why this exists?
Traditional SSH automation runs individual commands without state tracking between executions. Other implementations rely on complex regex patterns to detect command completion. By using tmux as a persistent terminal multiplexer, this project eliminates that complexity entirely. The AI agent simply "looks" at the screen like a human would - the server provides visual snapshots, and the agent interprets prompts, errors, and output naturally.
Key Features
- Persistence: SSH connections stay alive in
tmuxeven if the MCP server or your AI client restarts. - Observability: You can manually run
tmux -L mcp-ssh ato see exactly what the agent is doing in real-time. - Isolation: Runs on its own dedicated tmux socket (
mcp-ssh), completely isolated from your personal tmux sessions. - Reliability: Uses
ssh -Gfor robust config resolution (handles aliases, identity files, etc.). - Safety: Built-in command validation to prevent common dangerous operations.
- File Transfer: Native tools for reading and writing remote files. Reads prefer a full-file SSH transfer and fall back to the existing PTY when needed.
Installation
Requirements
- tmux must be installed on your system
- Ubuntu/Debian:
apt install tmux - macOS:
brew install tmux - Arch:
pacman -S tmux
- Ubuntu/Debian:
Via uv (Recommended)
uv tool install mcp-ssh-tmux
Via pip
pip install mcp-ssh-tmux
Configuration
Add this to your mcp.json (e.g., in Claude Desktop, Cursor, or 1mcp):
{
"mcpServers": {
"ssh-tmux": {
"command": "uv",
"args": [
"run",
"mcp-ssh-tmux"
]
}
}
}
Note: If you installed via uv tool install, you can just use mcp-ssh-tmux as the command.
Tools
open_session(host, username, port): Opens a new SSH connection in a unique tmux window.send_command(session_id, command, lines, timeout): Sends a command and polls for a prompt/output. Returns only the lastlinesof terminal output/scrollback.timeout(default 2.0s) controls how long to wait — increase for slower commands like package installs.send_keys(session_id, keys): Sends raw keystrokes without Enter. Use for Ctrl+C, Ctrl+D, interactive input, etc.get_snapshot(session_id, lines): Captures the current screen state. Returns only the lastlinesof terminal output/scrollback.read_remote_file(session_id, remote_path, fallback_lines): Reads a remote text file. Prefer this overcatviasend_command()when you need the full file contents.fallback_linescontrols bounded tmux-history capture if direct SSH read is unavailable.write_remote_file(session_id, remote_path, content, append): Writes content to a remote file.list_sessions(): Lists all active SSH windows.cleanup_dead_sessions(max_age_seconds): Kills all windows where the SSH connection has closed. Optionally filters by how long the session has been dead.close_session(session_id): Kills the window and cleans up. WARNING: This terminates any running processes in the session. For long-running tasks, leave the session open and monitor withget_snapshot().
Transport Modes
By default, the server uses stdio for communication with MCP clients. You can switch to the modern Streamable HTTP transport using environment variables:
# Start server in HTTP mode on port 8080
FASTMCP_TRANSPORT=http FASTMCP_PORT=8080 mcp-ssh-tmux
The server will be available at http://localhost:8080/mcp.
Important Notes
Automatic Cleanup
- Background Reaper: The server automatically cleans up sessions that have been dead (disconnected) for more than 24 hours.
- Manual Cleanup: Use
cleanup_dead_sessions()to manually clear disconnected sessions at any time.
Reading Files
- Use
read_remote_file()for file contents:send_command("cat ...")andget_snapshot()are screen/snapshot tools, so they only return the tail of terminal output. linescontrols snapshot depth: Increaselinesonsend_command()orget_snapshot()when you need more terminal history, but useread_remote_file()for actual file reads.fallback_linescontrols PTY fallback depth: If direct SSH file read is unavailable,read_remote_file()inspects only the lastfallback_linesof tmux history. Increase it when needed, but keep it bounded.- Best for text files:
read_remote_file()is intended for configs, source, logs, and similar text content.
Session Management
- Do not close sessions with active processes: Closing a session terminates all running commands (builds, downloads, etc.)
- Monitor long-running tasks: Use
get_snapshot()to check progress without closing the session - Sessions persist: SSH connections remain alive in tmux even if the MCP server restarts
- Isolated Tmux Socket: The server runs its own tmux server on a separate socket (
mcp-ssh) to prevent interfering with your personal tmux sessions. - Manual inspection: To manually connect to the MCP tool's tmux session, you must use the
-Lflag and specify the socket:tmux -L mcp-ssh a # or tmux -L mcp-ssh attach -t mcp-ssh
Acknowledgments
Built with FastMCP and libtmux.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
Star History
If you find this project useful, please consider giving it a star! ⭐
License
MIT
Вопросы о ssh-tmux MCP
Какие инструменты предоставляет ssh-tmux MCP?
Он предоставляет 9 инструментов, включая open_session, send_command, send_keys, get_snapshot, read_remote_file.
Как я могу видеть, что делает агент в режиме реального времени?
Вы можете вручную выполнить команду tmux, чтобы подключиться к выделенному сокету и просмотреть активные сессии.
Остаются ли SSH-соединения активными при перезагрузке сервера?
Да, соединения остаются постоянными, так как они управляются внутри экземпляра tmux.