npm License: MIT

MCP-сервер, предоставляющий ИИ-ассистентам полноценные возможности удаленного управления по SSH/SFTP: управление сессиями, выполнение команд, интерактивные оболочки, передача файлов, перенаправление портов и системная диагностика.

Работает с Claude Desktop, VS Code + GitHub Copilot и любым клиентом, совместимым с MCP.

Пакеты

Пакет	Описание
`ssh-mcp-server`	MCP-сервер (49 инструментов) — автономный CLI и npm-пакет
`ssh-mcp-vscode`	Расширение для VS Code — автоматическая регистрация сервера в GitHub Copilot

Возможности

Управление сессиями — подключение/отключение/проверка связи с аутентификацией по паролю или ключу
Выполнение команд — запуск команд с захватом stdout/stderr, тайм-аутами и кодами завершения
Выполнение через sudo — выполнение команд с повышенными привилегиями с вводом пароля через stdin (никогда не логируется)
Фоновые задачи — длительные команды с опросом состояния и отменой
Интерактивные оболочки — PTY-оболочки с поддержкой чтения/записи/изменения размера
SFTP-операции — загрузка, скачивание, чтение, запись, удаление, список, статистика
Перенаправление портов — локальные (-L) и удаленные (-R) SSH-туннели
Системная диагностика — ОС, CPU, память, диск, сеть, нагрузка, процессы
Поиск и анализ файлов — поиск файлов, grep по содержимому, diff, tail, контрольные суммы
Управление сервером — службы, процессы, cron, сетевая диагностика, пользователи
Многохостовые рабочие процессы — широковещательные команды, передача файлов между хостами, прыжковые/бастионные соединения, выполнение скриптов
Аналитика сессий — снимки системы, сравнение снимков, закладки соединений
Работа с контейнерами — список, логи, выполнение команд для контейнеров Docker/Podman
Аудит-логирование — структурированные логи в формате NDJSON с фильтрацией

Быстрый старт

Автономно (npm)

npm install -g simple-ssh-mcp-server

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": ["ssh-mcp-server"],
      "env": {
        "SSH_MCP_MAX_CONNECTIONS": "10",
        "SSH_MCP_HOST_KEY_MODE": "accept"
      }
    }
  }
}

VS Code + GitHub Copilot

Установите расширение SSH MCP для VS Code — сервер запускается автоматически при запуске VS Code. Требуется VS Code 1.99+ и GitHub Copilot.

Инструменты (49)

Категория	Инструменты
Сессии	`ssh_connect`, `ssh_disconnect`, `ssh_list_sessions`, `ssh_session_ping`
Выполнение	`ssh_exec`, `ssh_sudo_exec`
Фон	`ssh_exec_background`, `ssh_exec_poll`, `ssh_exec_poll_list`, `ssh_exec_cancel`
Оболочки	`ssh_shell_open`, `ssh_shell_write`, `ssh_shell_read`, `ssh_shell_resize`, `ssh_shell_close`, `ssh_shell_list`
SFTP	`ssh_sftp_list`, `ssh_sftp_upload`, `ssh_sftp_download`, `ssh_sftp_read`, `ssh_sftp_write`, `ssh_sftp_delete`, `ssh_sftp_stat`
Перенаправление портов	`ssh_port_forward_local`, `ssh_port_forward_remote`, `ssh_port_forward_list`, `ssh_port_forward_remove`
Поиск файлов	`ssh_find`, `ssh_grep`, `ssh_diff`, `ssh_tail`, `ssh_checksum`
Управление сервером	`ssh_service`, `ssh_process`, `ssh_cron`, `ssh_network`, `ssh_user`
Многохостовые	`ssh_broadcast`, `ssh_transfer`, `ssh_jump_connect`, `ssh_script`
Аналитика сессий	`ssh_snapshot`, `ssh_snapshot_diff`, `ssh_bookmark`
Контейнеры	`ssh_container_list`, `ssh_container_logs`, `ssh_container_exec`
Диагностика	`ssh_system_info`, `ssh_get_logs`

Конфигурация

Все настройки через переменные окружения:

Переменная	По умолчанию	Описание
`SSH_MCP_MAX_CONNECTIONS`	`10`	Макс. количество одновременных SSH-сессий
`SSH_MCP_LOG_DIR`	`~/.ssh-mcp/logs`	Директория для аудит-логов
`SSH_MCP_DEFAULT_TERM`	`xterm-256color`	Терминал по умолчанию для PTY-оболочек
`SSH_MCP_DEFAULT_COLS`	`220`	Ширина терминала
`SSH_MCP_DEFAULT_ROWS`	`50`	Высота терминала
`SSH_MCP_EXEC_TIMEOUT_MS`	`30000`	Тайм-аут команды (мс)
`SSH_MCP_HOST_KEY_MODE`	`accept`	Ключ хоста: `accept`, `strict`, `ask`
`SSH_MCP_ENV`	`development`	`production` по умолчанию использует `strict` для ключей хоста

См. README сервера для получения полной справки по конфигурации.

Безопасность

Пароли sudo вводятся через stdin, никогда не логируются
ANSI-последовательности удаляются из вывода
Усечение вывода предотвращает чрезмерное потребление памяти
SSH keepalives обнаруживают разорванные соединения
ESLint security plugin + Gitleaks + CodeQL + Trivy в CI

Лицензия

MIT

Simple SSH MCP Server