SSH MCP: три сервера для работы агента на ваших серверах и VPS

classfang/ssh-mcp-server· Проверено 12.11.2026· 1 тыс.на GitHub

Агент заходит на ваши серверы по SSH: выполняет команды, читает и пишет файлы, гоняет долгие задачи в фоне. Доступ ограничивается белым списком команд, режимом только чтения или подтверждением опасных действий.

3 реализации:

Запускается одной строкой npx, хост и ключ задаются прямо в args; есть белый и чёрный списки команд, режим для бастиона и HTTP-транспорт.

Как подключить

Что сделать до подключения

Node.js

Доступ к серверу по SSH: пароль, приватный ключ или ssh-agent; можно взять хост из ~/.ssh/config

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio ssh \
  -- npx -y @fangjunjie/ssh-mcp-server --host '<адрес сервера>' --port 22 --username '<пользователь>' --privateKey '~/.ssh/id_rsa'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.ssh]
command = "npx"
args = ["-y", "@fangjunjie/ssh-mcp-server", "--host", "<адрес сервера>", "--port", "22", "--username", "<пользователь>", "--privateKey", "~/.ssh/id_rsa"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "<адрес сервера>",
        "--port",
        "22",
        "--username",
        "<пользователь>",
        "--privateKey",
        "~/.ssh/id_rsa"
      ]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "ssh": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "<адрес сервера>",
        "--port",
        "22",
        "--username",
        "<пользователь>",
        "--privateKey",
        "~/.ssh/id_rsa"
      ]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "<адрес сервера>",
        "--port",
        "22",
        "--username",
        "<пользователь>",
        "--privateKey",
        "~/.ssh/id_rsa"
      ]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "<адрес сервера>",
        "--port",
        "22",
        "--username",
        "<пользователь>",
        "--privateKey",
        "~/.ssh/id_rsa"
      ]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "ssh": {
        "type": "local",
        "command": [
          "npx",
          "-y",
          "@fangjunjie/ssh-mcp-server",
          "--host",
          "<адрес сервера>",
          "--port",
          "22",
          "--username",
          "<пользователь>",
          "--privateKey",
          "~/.ssh/id_rsa"
        ]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "<адрес сервера>",
        "--port",
        "22",
        "--username",
        "<пользователь>",
        "--privateKey",
        "~/.ssh/id_rsa"
      ]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host",
        "<адрес сервера>",
        "--port",
        "22",
        "--username",
        "<пользователь>",
        "--privateKey",
        "~/.ssh/id_rsa"
      ]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

execute-commandвыполняет команду на сервере

uploadзаливает файл или папку

downloadскачивает файл или папку

read-fileчитает текстовый файл частями

write-fileпишет или дописывает файл

list-serversпоказывает настроенные серверы

job-startзапускает фоновую задачу

job-statusпоказывает статус и вывод задачи

job-killостанавливает фоновую задачу

job-listперечисляет последние задачи

Хосты, роли и политику описывает файл config.toml; разрушительные и sudo-команды ждут вашего подтверждения в диалоге клиента, все действия пишутся в журнал.

Как подключить

Что сделать до подключения

Node.js 18.19 или 20.6 и новее

Пакет ssh-mcp: npm install -g ssh-mcp

Файл config.toml с профилем хоста: ~/.config/ssh-mcp/config.toml на Linux, ~/Library/Application Support/ssh-mcp/config.toml на macOS, %APPDATA%\ssh-mcp\config.toml на Windows; на Linux и macOS права 700 на папку и 600 на файл

SSH_MCP_PASSWORD

пароль SSH, нужен только при auth = "password" в профиле; с ключом или ssh-agent переменная не нужна

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio ssh-mcp \
  -- ssh-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.ssh-mcp]
command = "ssh-mcp"
args = []

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "ssh-mcp": {
      "command": "ssh-mcp",
      "args": []
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "ssh-mcp": {
      "type": "stdio",
      "command": "ssh-mcp",
      "args": []
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "ssh-mcp": {
      "command": "ssh-mcp",
      "args": []
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "ssh-mcp": {
      "command": "ssh-mcp",
      "args": []
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "ssh-mcp": {
        "type": "local",
        "command": ["ssh-mcp"]
      }
    }
  }
}

{
  "mcpServers": {
    "ssh-mcp": {
      "command": "ssh-mcp",
      "args": []
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "ssh-mcp": {
      "command": "ssh-mcp",
      "args": []
    }
  }
}

Инструменты сервера

list-connectionsпоказывает хосты и статус

open-sessionоткрывает сессию с состоянием или фоновую

list-sessionsперечисляет открытые сессии

close-sessionзакрывает сессию

read-session-outputчитает вывод фоновой сессии

read-commandвыполняет разрешённую команду чтения

run-commandвыполняет произвольную команду

privileged-commandвыполняет команду через sudo

sftp-uploadзаливает файл по SFTP

sftp-downloadскачивает файл по SFTP

sftp-listпоказывает содержимое папки

sftp-upload-fileпередаёт файл в обход контекста модели

sftp-download-fileскачивает файл на диск в обход контекста

signal-processпосылает сигнал процессу

reload-configперечитывает config.toml без перезапуска

37 инструментов: деплой, бэкапы и запросы к базам, мониторинг, туннели, группы серверов; есть настольное приложение с окном подтверждения и зашифрованным хранилищем паролей.

Как подключить

Что сделать до подключения

Node.js 18 или новее

Пакет и сервер: npm install -g mcp-ssh-manager, затем ssh-manager server add — мастер спросит хост, пользователя, ключ или пароль

rsync для ssh_sync; sshpass нужен только для синхронизации по паролю

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio mcp-ssh-manager \
  -- mcp-ssh-manager

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-ssh-manager]
command = "mcp-ssh-manager"
args = []

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-ssh-manager": {
      "command": "mcp-ssh-manager",
      "args": []
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-ssh-manager": {
      "type": "stdio",
      "command": "mcp-ssh-manager",
      "args": []
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-ssh-manager": {
      "command": "mcp-ssh-manager",
      "args": []
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-ssh-manager": {
      "command": "mcp-ssh-manager",
      "args": []
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-ssh-manager": {
        "type": "local",
        "command": ["mcp-ssh-manager"]
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-ssh-manager": {
      "command": "mcp-ssh-manager",
      "args": []
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-ssh-manager": {
      "command": "mcp-ssh-manager",
      "args": []
    }
  }
}

Инструменты сервера

ssh_list_serversпоказывает серверы, группы и режимы

ssh_executeвыполняет команду

ssh_execute_sudoвыполняет команду через sudo

ssh_uploadзаливает файл

ssh_downloadскачивает файл

ssh_syncсинхронизирует папки через rsync

ssh_deployвыкладывает файлы с бэкапом и перезапуском

ssh_health_checkпроверяет CPU, память, диск и сеть

ssh_service_statusпоказывает статус сервиса

ssh_process_managerпоказывает и завершает процессы

ssh_tailследит за логом

ssh_monitorследит за ресурсами

ssh_backup_createделает бэкап базы или файлов

ssh_backup_restoreвосстанавливает бэкап

ssh_backup_scheduleставит бэкап в cron

ssh_db_dumpснимает дамп базы

ssh_db_listпоказывает базы и таблицы

ssh_db_queryвыполняет SELECT к базе

ssh_execute_groupвыполняет команду на группе серверов

Показано 19 из 37.

Что попросить агента

«Почему <сервер> сейчас тормозит?»MCP SSH Manager вызовет ssh_health_check и ssh_process_manager: покажет CPU, память, диск, нагрузку и тяжёлые процессы

«Сделай бэкап базы на <сервер> перед деплоем»MCP SSH Manager снимет сжатый дамп MySQL, PostgreSQL или MongoDB с меткой времени через ssh_backup_create

«Покажи хвост лога ошибок nginx на staging»MCP SSH Manager будет выводить строки лога через ssh_tail

«Залей ./dist на <сервер>:/var/www и перезапусти nginx»MCP SSH Manager выложит файлы и перезапустит сервис через ssh_deploy

«Запусти сборку на <сервер> в фоне и скажи, когда закончится»ssh-mcp-server запустит команду через job-start и будет опрашивать вывод и код выхода через job-status

Для каких задач

Выполнить команду на удалённом сервере и получить вывод

Залить или скачать файлы и целые папки

Запустить сборку или деплой в фоне и следить за выводом

Проверить загрузку CPU, память и диск на сервере

Снять дамп MySQL, PostgreSQL или MongoDB перед выкладкой

Разрешить агенту только чтение или только команды из белого списка

Ограничения

У ssh-mcp-server без --whitelist агент выполнит на сервере любую команду; пароль в args, как в примерах этого сервера, виден через ps aux, надёжнее ключ или ssh-agent

SSH MCP Server v2 без config.toml отклоняет все вызовы; подтверждение опасных команд идёт через elicitation, и если клиент его не поддерживает, такие команды отклоняются с APPROVAL_UNAVAILABLE

У SSH MCP Server v2 интерактивные сессии не работают с хостами на Windows OpenSSH

Все 37 инструментов MCP SSH Manager занимают около 43,5 тыс. токенов контекста; режим Minimal оставляет 5 инструментов и около 3,5 тыс.

Если не работает

Claude Code зависает или пишет Interrupted

Скорее всего, вывод команды слишком большой. Уменьшите MCP_SSH_MAX_OUTPUT_LENGTH и просите tail -n 100 вместо cat всего файла (MCP SSH Manager).

MCP SSH Manager: Connection failed или Permission denied

Запустите ssh-manager server test <имя>: он покажет, виноваты DNS, файрвол или учётные данные. При Permission denied проверьте chmod 600 на ключе и имя пользователя.

SSH MCP Server v2 отклоняет все вызовы

Сервер запущен без конфига: создайте config.toml по пути для вашей системы и вызовите reload-config с action: "reload" или перезапустите сервер.

SSH MCP Server v2 не стартует из-за прав на конфиг

На Linux и macOS выполните chmod 700 для папки ssh-mcp и chmod 600 для config.toml.

Разрушительные команды отклоняются с APPROVAL_UNAVAILABLE

Клиент не поддерживает elicitation, и SSH MCP Server v2 не может спросить подтверждение. Возьмите клиент с поддержкой elicitation или поставьте для тестового профиля approvalPolicy = "auto".

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
ssh-mcp-server	classfang	1 тыс.	локально	не нужен	10	4 ноября 2026
SSH MCP Server v2	tufantunc	874	локально	не нужен	15	12 ноября 2026
MCP SSH Manager	bvisible	539	локально	не нужен	37	10 ноября 2026

Частые вопросы

Какой из трёх серверов выбрать?

ssh-mcp-server — быстрый старт: хост и ключ прямо в args. SSH MCP Server v2 — для работы с ролями, политиками и подтверждением команд. MCP SSH Manager — когда нужны деплой, бэкапы, базы и мониторинг.

Агент увидит мой пароль или ключ?

У ssh-mcp-server учётные данные хранятся локально и модели не передаются. MCP SSH Manager держит пароли и фразы ключей в хранилище AES-256-GCM с ключом в системной связке. SSH MCP Server v2 берёт пароль из переменной SSH_MCP_PASSWORD, ssh-agent или конфига.

Как запретить агенту опасные команды?

В ssh-mcp-server задайте --whitelist или --blacklist: регулярные выражения через запятую. В SSH MCP Server v2 режим ask-destructive спрашивает подтверждение по умолчанию, ask-all спрашивает про каждую команду. В MCP SSH Manager поставьте серверу режим readonly или restricted.

Можно зайти на сервер через бастион?

ssh-mcp-server работает через бастион с флагом --transport-mode shell, но upload и download в этом режиме отключены. В SSH MCP Server v2 укажите в профиле внутреннего хоста поле via с именем профиля бастиона.

Как подключить сразу несколько серверов?

В ssh-mcp-server опишите их в JSON и передайте через --config-file или перечислите алиасы из ~/.ssh/config через запятую в --host. В SSH MCP Server v2 это несколько [[profiles]] в config.toml, в MCP SSH Manager — группы и ssh_execute_group.

Как подключить SSH MCP server к Claude Code?

Для MCP SSH Manager: npm install -g mcp-ssh-manager, ssh-manager server add, затем claude mcp add ssh-manager mcp-ssh-manager и перезапуск Claude Code. Для SSH MCP Server v2: claude mcp add --transport stdio ssh-mcp -- ssh-mcp.

Как подключить SSH MCP к Codex?

MCP SSH Manager: в ~/.codex/config.toml добавьте [mcp_servers.ssh-manager] с command = "mcp-ssh-manager", переменной SSH_CONFIG_PATH и startup_timeout_ms = 20000, а серверы опишите в ~/.codex/ssh-config.toml. Для остальных вариантов откройте вкладку Codex в блоке «Как подключить».

Как через MCP управлять VPS?

Укажите адрес VPS, пользователя и ключ: в ssh-mcp-server через --host, --username и --privateKey, в SSH MCP Server v2 — профилем в config.toml. Дальше агент выполняет команды и переносит файлы по SSH.

Можно запустить SSH MCP по HTTP?

Да, у ssh-mcp-server: флаг --mcp-transport http поднимает эндпоинт http://127.0.0.1:3000/mcp. Если слушаете не только 127.0.0.1, задайте токен --http-token или SSH_MCP_HTTP_TOKEN.

Работает ли сервер из России?

Сервер запускается на вашем компьютере и подключается к вашим хостам по SSH, зарубежные аккаунты и ключи API не нужны.

SSH MCP: три сервера для работы агента на ваших серверах и VPS

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы