sshmcp — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер связывает ассистента с серверами по SSH. Помогает запускать удалённые команды, передавать файлы через SFTP и работать через бастионы.
claude mcp add sshmcp -- npx -y @nl4ever/sshmcpЧто делает sshmcp
Сервер предоставляет 21 инструмент для удалённого администрирования. Подключения сохраняются в пуле по идентификаторам вроде server_id, поэтому переключаться между тестовыми и рабочими контурами можно без повторной авторизации. Передача файлов идёт через SFTP по локальным путям: содержимое не попадает в контекст модели и не тратит токены. Для тяжёлых файлов предусмотрена асинхронная отправка с проверкой статуса, а папки сервер автоматически пакует в tar.gz перед пересылкой.
Поддерживаются ключи, пароли, агент SSH, двухфакторная проверка и прокси SOCKS4/5. Доступ во внутренние сети возможен через промежуточный узел (jump host).
Конфигурация с параметрами хостов сохраняется в файле ~/.ssh-mcp/config.json. Пароли лежат в нём открытым текстом, поэтому для рабочих серверов безопаснее настроить авторизацию по ключам. Для работы нужен Node.js версии 18 или новее.
Какие задачи решает
- Выполнять shell-команды на удалённых серверах прямо из диалога с моделью
- Загружать папки на хост с автоматической архивацией и распаковкой
- Подключаться к закрытым машинам через промежуточные jump-хосты и SOCKS-прокси
- Копировать тяжёлые файлы в фоновом режиме без расхода токенов контекста
Примеры запросов агенту
- Проверь статус службы nginx на сервере prod
- Загрузи каталог ./dist на сервер dev в папку /var/www/site
- Подключись временно к 192.168.1.50 по SSH под пользователем root и покажи свободное место
Как установить sshmcp
Командой платформы
claude mcp add sshmcp -- npx -y @nl4ever/sshmcpКомандой платформы
codex mcp add sshmcp -- npx -y @nl4ever/sshmcpФайл настроек
{
"mcpServers": {
"sshmcp": {
"command": "npx",
"args": [
"-y",
"@nl4ever/sshmcp"
]
}
}
}Файл настроек
{
"servers": {
"sshmcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@nl4ever/sshmcp"
]
}
}
}Командой платформы
gemini mcp add sshmcp npx -y @nl4ever/sshmcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о sshmcp
Как установить sshmcp в Claude Code?
Выполните команду claude mcp add sshmcp -- npx -y @nl4ever/sshmcp. Клиент зарегистрирует сервер и сразу сделает доступными инструменты SSH.
Почему передача файлов не расходует контекст модели?
Сервер пересылает файлы напрямую по протоколу SFTP между локальной файловой системой и удалённой машиной. Содержимое файлов не передаётся текстовыми блоками в окно промпта.
Где сохраняются реквизиты серверов?
Все сохранённые серверы и настройки прокси записываются в локальный файл ~/.ssh-mcp/config.json.
