mcp-ssh-manager
mcp-ssh-manager — MCP-сервер сообщества (автор — bvisible). SSH для агентов: команды, файлы, бэкапы, одобрения, хранилище секретов и аудит. Ставится через npx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- bvisible
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- other
- ОС
- linux, macos, windows
- Языки
- javascript
Уровень риска: high
Shell и файлы на удалённых серверах; по умолчанию unrestricted; режимы readonly/restricted, подтверждение, vault, аудит.
Настройка клиентов
{
"code": "[mcp_servers.ssh-manager]\ncommand = \"mcp-ssh-manager\"\nenv = { SSH_CONFIG_PATH = \"/Users/you/.codex/ssh-config.toml\" }\nstartup_timeout_ms = 20000",
"file": "~/.codex/config.toml",
"lang": "toml",
"notes": "Дословно из README; серверы в ~/.codex/ssh-config.toml",
"verified": "docs"
}
Что умеет
mcp-ssh-manager — MCP-сервер для SSH. Через него Claude Code, Claude Desktop, OpenAI Codex и другие MCP-клиенты работают на ваших реальных серверах: выполняют команды, передают файлы, запрашивают базы данных, делают бэкапы и проверяют состояние. При этом вы видите, что делает агент, и можете это запретить.
Возможности по README (37 инструментов):
- команды:
ssh_executeна одном сервере или на группе серверов, последовательно или параллельно; - файлы: загрузка и синхронизация (
ssh_upload,ssh_syncчерез rsync) с учётом владельца, прав и резервной копии для отката; - базы данных: сжатые бэкапы MySQL, PostgreSQL и MongoDB с политикой хранения.
ssh_db_queryвыполняет толькоSELECTвнутри транзакции только для чтения; - мониторинг: CPU, память, диск, нагрузка и топ процессов за один запрос, потоковый просмотр логов;
- туннели: проброс локального порта (
ssh_tunnel_create), например к базе данных на production.
Начиная с версии 4.0 есть панель управления: ssh-manager control в браузере или настольное приложение. В ней видно, какие команды выполняет агент, и можно подтверждать действия до запуска, работать с файлами на двух машинах рядом, открывать интерактивный shell и смотреть журнал аудита.
Кому подойдёт
- DevOps-инженерам и администраторам, которые поручают ассистенту рутинную работу на серверах.
- Разработчикам, которые деплоят и разбирают проблемы на staging и production.
- Командам, которым нужен контроль: подтверждение команд, ограничения по каждому серверу и журнал действий агента.
Похожие серверы — в категории облака и DevOps.
Установка
Нужен Node 18+ (Linux, macOS или Windows). Для ssh_sync нужен rsync, а sshpass — только при синхронизации с паролем. Есть также настольное приложение 4.1.0 для macOS, Windows и Linux со встроенным движком, без Node.js. Сборка для Windows пока не подписана — README советует сверить SHA-256 с манифестом релиза.
Команда ssh-manager server add запускает пошаговое добавление сервера: хост, пользователь, ключ или пароль.
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
npm install -g mcp-ssh-manager # or: brew tap bvisible/mcp-ssh-manager https://github.com/bvisible/mcp-ssh-manager && brew install ssh-manager
ssh-manager server add # guided: host, user, key or password
claude mcp add ssh-manager mcp-ssh-managerДля Codex серверы описываются в отдельном файле ~/.codex/ssh-config.toml (хост, пользователь, путь к ключу, группа). В Claude Code флаг --scope project записывает .mcp.json, который можно закоммитить для команды. После добавления перезапустите клиент.
Проверка
Спросите ассистента, почему тормозит сервер, или попросите проверить свободное место на всех серверах группы. Чтобы видеть его действия, запустите ssh-manager control.
Примеры задач
Сделай бэкап базы данных перед деплоем.Покажи хвост лога ошибок nginx на staging.Риски
По словам авторов, SSH-сервер — самый опасный инструмент, который можно дать агенту: это shell на важных машинах. По умолчанию режим unrestricted разрешает всё. Защита по README:
- режимы для каждого сервера:
readonlyзапрещает изменяющие инструменты (деплой, загрузку, sudo, импорт баз),restrictedпропускает только команды, которые подходят под разрешающие шаблоны и не подходят под запрещающие; - подтверждение включается в панели для каждого сервера (
never,destructive,always) и хранится в зашифрованном хранилище. Если панель не отвечает, запрос отклоняется; - хранилище учётных данных:
ssh-manager vaultшифрует секреты AES-256-GCM, мастер-ключ лежит в связке ключей ОС; - guard для Claude Code:
ssh-manager guard installне даёт агенту обходить инструменты черезssh,scpиrsyncв собственном терминале. Авторы подчёркивают, что это защита от случайностей, а не граница безопасности; - пароль sudo передаётся через stdin канала SSH и не виден в
ps. Все аргументы оболочки экранируются.
Для production включайте readonly или restricted, журнал аудита и подтверждение разрушительных команд.
Частые вопросы
Можно ли разрешить агенту только чтение?
Да, режим readonly для сервера запрещает все изменяющие инструменты, а чтение продолжает работать.
Нужно ли настольное приложение?
Нет, движок работает и без интерфейса, с конфигом .env или TOML. Приложение и ssh-manager control добавляют наблюдение и подтверждения.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
GitHub MCP Server
Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.