# SSH MCP Server

Управляет ключами и агентом SSH, находит причины сбоев авторизации и открывает доступ к удалённым серверам через SFTP и терминал. Пригодится при падении Git или деплоя в субпроцессах.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Автор: YawLabs
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/YawLabs/ssh-mcp
- Обновлён: 2026-10-15
- HTML: https://affpapa.org/nevibecode/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` файл напрямую.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add ssh-mcp -- npx -y @yawlabs/ssh-mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add ssh-mcp-server -- npx -y @yawlabs/ssh-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ssh-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@yawlabs/ssh-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "ssh-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@yawlabs/ssh-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add ssh-mcp-server npx -y @yawlabs/ssh-mcp
```

## Когда брать
- настроить запуск ssh-agent и загрузку ключей в изолированном окружении терминала
- исправить ошибку проверки хоста при пересоздании удалённого сервера
- передать и прочитать файлы на сервере через SFTP без ручного разбора консоли
- выполнить команду параллельно на нескольких серверах с едиными переменными окружения

## Примеры запросов агенту
- Проверь авторизацию по SSH до GitHub и перезапусти ssh-agent, если сокет недоступен
- Подключись к серверу prod-app и проверь статус сервиса systemd через `ssh_service_status`
- Скачай последние 50 строк лога с хоста staging с помощью инструмента `ssh_tail`

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33989
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81163
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23654
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18779
- [Coder](https://affpapa.org/nevibecode/mcp/coder.md) — MCP-сервер · ★ 17191
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12110

## Другие версии с тем же именем
- [SSH MCP Server · hypnosis](https://affpapa.org/nevibecode/mcp/hypnosis-ssh-mcp-server.md) — ★ 6

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md