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, аудит.

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

codex
{
    "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 для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники