SSH MCP Server · yawlabs — MCP-сервер для Claude Code: как настроить
Управляет ключами и агентом SSH, находит причины сбоев авторизации и открывает доступ к удалённым серверам через SFTP и терминал. Пригодится при падении Git или деплоя в субпроцессах.
claude mcp add ssh-mcp -- npx -y @yawlabs/ssh-mcpЧто делает SSH MCP Server
Когда языковая модель выполняет git push или пытается развернуть код на виртуальной машине, процесс часто завершается ошибкой авторизации. Фоновые подпроцессы теряют сокет ssh-agent, а смена ключа хоста блокирует дальнейшие шаги. Сервер устраняет подобные сбои: поднимает локальный агент, подгружает ключи из каталога ~/.ssh/, чистит устаревшие записи в known_hosts и проверяет доступ к репозиториям.
Для работы с удалёнными хостами сервер даёт вызов команд через ssh_exec, параллельный запуск на группе машин через ssh_multi_exec и файловые операции по SFTP. Клиент SFTP читает файлы размером до 10 МБ, поддерживает постраничное чтение по смещению и создаёт директории. Удаление каталогов через SFTP работает только для пустых папок, поэтому рекурсивную очистку нужно запускать командой rm -rf через шелл. Если удалённый вызов падает, инструмент сразу возвращает отчёт автоматической диагностики с инструкцией по исправлению.
На Windows с Node.js 20 и новее запуск требует обёртки через cmd /c, иначе система не сможет запустить исполняемый .cmd файл напрямую.
Какие задачи решает
- настроить запуск ssh-agent и загрузку ключей в изолированном окружении терминала
- исправить ошибку проверки хоста при пересоздании удалённого сервера
- передать и прочитать файлы на сервере через SFTP без ручного разбора консоли
- выполнить команду параллельно на нескольких серверах с едиными переменными окружения
Примеры запросов агенту
- Проверь авторизацию по SSH до GitHub и перезапусти ssh-agent, если сокет недоступен
- Подключись к серверу prod-app и проверь статус сервиса systemd через
ssh_service_status - Скачай последние 50 строк лога с хоста staging с помощью инструмента
ssh_tail
Как установить SSH MCP Server
Командой платформы
claude mcp add ssh-mcp -- npx -y @yawlabs/ssh-mcpКомандой платформы
codex mcp add ssh-mcp-server -- npx -y @yawlabs/ssh-mcpФайл настроек
{
"mcpServers": {
"ssh-mcp-server": {
"command": "npx",
"args": [
"-y",
"@yawlabs/ssh-mcp"
]
}
}
}Файл настроек
{
"servers": {
"ssh-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@yawlabs/ssh-mcp"
]
}
}
}Командой платформы
gemini mcp add ssh-mcp-server npx -y @yawlabs/ssh-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о SSH MCP Server
Как установить SSH MCP Server в Claude Code?
Выполните в терминале команду claude mcp add ssh-mcp -- npx -y @yawlabs/ssh-mcp. Либо используйте альтернативный вариант: claude mcp add ssh-mcp-server -- npx -y @yawlabs/ssh-mcp.
Что делает SSH MCP Server?
Он предоставляет набор инструментов для управления локальными ключами SSH, тестирования Git-доступа, выполнения команд на удалённых серверах и работы с файлами по SFTP. При ошибках подключения сервер запускает диагностику и подсказывает шаги для исправления.
Почему на Windows требуется особая команда запуска?
В среде Node.js 20 и выше процесс не может вызывать файлы .cmd напрямую. Из-за этого вызов npx в конфигурации клиента нужно оборачивать через cmd /c.
Похожие MCP-серверы
Все MCP-серверы по теме «DevOps и инфраструктура» →Сначала — SSH MCP Server от других авторов.
