# sshmcp

MCP-сервер связывает ассистента с серверами по SSH. Помогает запускать удалённые команды, передавать файлы через SFTP и работать через бастионы.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11
- Автор: NikolaNddTesla
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/NikolaNddTesla/ssh-mcp-server
- Обновлён: 2026-05-27
- HTML: https://affpapa.org/nevibecode/mcp/sshmcp

## Что делает

Сервер предоставляет 21 инструмент для удалённого администрирования. Подключения сохраняются в пуле по идентификаторам вроде `server_id`, поэтому переключаться между тестовыми и рабочими контурами можно без повторной авторизации. Передача файлов идёт через SFTP по локальным путям: содержимое не попадает в контекст модели и не тратит токены. Для тяжёлых файлов предусмотрена асинхронная отправка с проверкой статуса, а папки сервер автоматически пакует в `tar.gz` перед пересылкой.

Поддерживаются ключи, пароли, агент SSH, двухфакторная проверка и прокси SOCKS4/5. Доступ во внутренние сети возможен через промежуточный узел (jump host).

Конфигурация с параметрами хостов сохраняется в файле `~/.ssh-mcp/config.json`. Пароли лежат в нём открытым текстом, поэтому для рабочих серверов безопаснее настроить авторизацию по ключам. Для работы нужен Node.js версии 18 или новее.

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

## Установка

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

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## Когда брать
- Выполнять shell-команды на удалённых серверах прямо из диалога с моделью
- Загружать папки на хост с автоматической архивацией и распаковкой
- Подключаться к закрытым машинам через промежуточные jump-хосты и SOCKS-прокси
- Копировать тяжёлые файлы в фоновом режиме без расхода токенов контекста

## Примеры запросов агенту
- Проверь статус службы nginx на сервере prod
- Загрузи каталог ./dist на сервер dev в папку /var/www/site
- Подключись временно к 192.168.1.50 по SSH под пользователем root и покажи свободное место

## Похожие
- [termcp](https://affpapa.org/nevibecode/mcp/termcp.md) — MCP-сервер · ★ 59
- [agent-tool](https://affpapa.org/nevibecode/mcp/agent-tool.md) — MCP-сервер · ★ 24
- [Octofs](https://affpapa.org/nevibecode/mcp/octofs.md) — MCP-сервер · ★ 18
- [ssh](https://affpapa.org/nevibecode/mcp/ssh.md) — MCP-сервер · ★ 81
- [tunnel-doctor](https://affpapa.org/nevibecode/skills/tunnel-doctor.md) — скилл · 678 установок
- [omni-version-manager](https://affpapa.org/nevibecode/skills/omni-version-manager.md) — скилл · 975 установок

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