# SSH MCP Server

Инструмент даёт ИИ-агенту доступ к удалённым серверам и роутерам через системный OpenSSH. Помогает проверять логи и запускать команды без перерасхода токенов.

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

## Что делает

Сервер связывает агента с удалёнными машинами через штатный клиент `ssh` вашей операционной системы. Он подхватывает существующие настройки из `~/.ssh/config` и ключи доступа. Здесь нет компиляции бинарников. Для ускорения сессий поддерживается мультиплексирование соединений, поэтому повторная авторизация при каждом запросе не нужна.

Вместо сырого вывода терминала MCP-сервер возвращает структурированные ответы. Длинные выгрузки обрезаются, чтобы экономить контекст модели. Опасные команды блокируются автоматически.

Для запуска обязательны Node.js 18+ и утилита `ssh` в переменной `PATH`. Конфигурация серверов задаётся отдельным JSON-файлом через переменную `SSH_PROFILES_FILE`. Пользователям Windows придётся настроить доступ исключительно по ключам, так как пароли на этой платформе пока не поддерживаются.

## Требования
- Нужно: Node.js (команды через npx)
- Есть удалённый вариант (HTTP): адрес — в README
- Переменные окружения: `SSH_PROFILES_FILE`, `SSH_MCP_LOG_LEVEL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env SSH_PROFILES_FILE=<SSH_PROFILES_FILE> --env SSH_MCP_LOG_LEVEL=<SSH_MCP_LOG_LEVEL> --transport stdio hypnosis-ssh-mcp-server -- npx -y @hypnosis/ssh-mcp-server
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add hypnosis-ssh-mcp-server --env SSH_PROFILES_FILE=<SSH_PROFILES_FILE> --env SSH_MCP_LOG_LEVEL=<SSH_MCP_LOG_LEVEL> -- npx -y @hypnosis/ssh-mcp-server
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hypnosis-ssh-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@hypnosis/ssh-mcp-server"
            ],
            "env": {
                "SSH_PROFILES_FILE": "<SSH_PROFILES_FILE>",
                "SSH_MCP_LOG_LEVEL": "<SSH_MCP_LOG_LEVEL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "hypnosis-ssh-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@hypnosis/ssh-mcp-server"
            ],
            "env": {
                "SSH_PROFILES_FILE": "<SSH_PROFILES_FILE>",
                "SSH_MCP_LOG_LEVEL": "<SSH_MCP_LOG_LEVEL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e SSH_PROFILES_FILE=<SSH_PROFILES_FILE> -e SSH_MCP_LOG_LEVEL=<SSH_MCP_LOG_LEVEL> hypnosis-ssh-mcp-server npx -y @hypnosis/ssh-mcp-server
```
Вместо <…> подставьте свои значения

## Когда брать
- читать логи и статус процессов на удалённом сервере
- передавать файлы конфигурации на роутеры и VPS
- сокращать расход токенов за счёт фильтрации сырого вывода терминала
- блокировать запуск разрушительных команд на удалённой системе

## Примеры запросов агенту
- Проверь системные логи на сервере production и найди ошибки nginx
- Скопируй локальный файл `app.conf` на удалённый хост через профиль router
- Покажи свободное место на дисках удалённой машины

## Похожие
- [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 · yawlabs](https://affpapa.org/nevibecode/mcp/ssh-mcp-server.md) — ★ 6

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