MCP SSH Manager — удаленное управление SSH-серверами через Model Context Protocol 🚀

Сервер Model Context Protocol (MCP), который позволяет Claude Code и OpenAI Codex управлять несколькими SSH-соединениями. Выполняйте команды, передавайте файлы, управляйте базами данных, создавайте резервные копии, отслеживайте состояние системы и автоматизируйте задачи DevOps на ваших серверах — напрямую из вашего ИИ-ассистента.

🎉 Что нового в версии 3.2.2

Исправление глобальной установки и бинарный файл CLI (Выпущено: 7 апреля 2026 г.)

🔧 Исправлена глобальная установка: разрешение пути .env теперь использует цепочку резервных вариантов вместо жестко закодированного __dirname — корректно работает с npm install -g (#16, #19)
- Цепочка резервных вариантов: ~/.ssh-manager/.env → cwd/.env → ~/.env → проектный .env
- Автоматическое создание ~/.ssh-manager/.env при первом вызове ssh-manager server add
📦 CLI ssh-manager зарегистрирован как бинарный файл: npm install -g теперь создает команды mcp-ssh-manager и ssh-manager (#18)
⚡ Исправление состояния гонки: конфигурация сервера теперь полностью загружается до того, как MCP-сервер начинает принимать запросы

Related MCP server: MCP Server for FTP Access

Предыдущие релизы

v3.2.0 — Поддержка ProxyJump / Bastion Host (18 марта 2026 г.)

🔀 Поддержка ProxyJump: подключайтесь к серверам за бастионами/промежуточными хостами с помощью простого поля конфигурации PROXYJUMP (#15)
- Цепочка из нескольких прыжков (A → B → C) через рекурсивные соединения
- Обнаружение циклических зависимостей предотвращает бесконечные циклы
- Все инструменты работают прозрачно через промежуточные хосты
📦 Исправлена поддержка npx: npx mcp-ssh-manager теперь работает корректно (#14)

v3.1.5 — Поддержка SSH-агента и парольных фраз (5 марта 2026 г.)

🔑 Поддержка SSH-агента: автоматически использует ssh-agent, если доступен SSH_AUTH_SOCK — ключи, защищенные парольной фразой, работают прозрачно
🔐 Конфигурация парольной фразы: новое поле passphrase как для .env, так и для форматов TOML

Спасибо @snjax за первоначальный вклад (#12).

v3.1.4 — Поддержка SSH-хостов на Windows (22 февраля 2026 г.)

🪟 Исправление SSH-хоста на Windows: команды больше не завершаются ошибкой на хостах Windows, работающих под управлением OpenSSH (#10)
Новое поле конфигурации для каждого сервера platform (SSH_SERVER_FOO_PLATFORM=windows или platform = "windows" в TOML)
Когда platform=windows, обертка Linux timeout/sh -c пропускается, и вместо нее используется собственный тайм-аут SSH-библиотеки
Все инструменты (ssh_execute, ssh_tail, ssh_monitor, ssh_deploy, ssh_execute_sudo, ssh_group_execute) учитывают платформу

v3.1.2 — Исправление совместимости с Windows (9 февраля 2026 г.)

🪟 Поддержка Windows: исправлен сбой на Windows, где process.env.HOME не определен (#8)
Теперь использует os.homedir() для кроссплатформенной совместимости (Linux, macOS, Windows)

v3.1.0 — Система активации инструментов (15 ноября 2025 г.)

🎯 Оптимизация использования контекста

Сокращение контекста на 92%: включайте только те инструменты, которые вам нужны (минимальный режим: 5 инструментов вместо 37)
CLI управления инструментами: ssh-manager tools list/configure/enable/disable
6 групп инструментов: Core, Sessions, Monitoring, Backup, Database, Advanced
Экспорт автоподтверждения: генерация конфигураций автоподтверждения для Claude Code

v3.0.0 — Платформа Enterprise DevOps (1 октября 2025 г.)

Этот релиз добавляет 12 новых инструментов MCP, превращая SSH Manager в комплексную платформу автоматизации DevOps:

💾 Система резервного копирования и восстановления (4 инструмента)

Автоматизированное резервное копирование для MySQL, PostgreSQL, MongoDB и файловых систем
Умное планирование с интеграцией cron и политиками хранения
Восстановление в один клик с поддержкой кросс-баз данных
Отслеживание метаданных для аудита и соответствия требованиям

🏥 Здоровье и мониторинг (4 инструмента)

Проверки состояния в реальном времени с метриками CPU, RAM, диска и сети
Мониторинг сервисов для nginx, mysql, docker и пользовательских сервисов
Управление процессами с сортировкой по CPU/RAM и возможностью завершения
Пороги оповещений с настраиваемыми уведомлениями

🗄️ Управление базами данных (4 инструмента)

Безопасные дампы баз данных со сжатием и выборочным экспортом
Импорт баз данных с автоматической распаковкой
Исследование схемы с перечислением баз данных, таблиц и коллекций
Безопасные запросы с предотвращением SQL-инъекций (только SELECT)

📊 Всего: 37 инструментов MCP | 🔧 ~4100 строк добавленного кода | ✅ Готов к работе в продакшене

Читать полный список изменений →

📑 Содержание

🌟 Возможности

Основные возможности

🔗 Несколько SSH-соединений — управляйте неограниченным количеством SSH-серверов из одного интерфейса
🔐 Безопасная аутентификация — поддержка паролей, SSH-ключей и аутентификации через ssh-agent (включая ключи, защищенные парольной фразой)
🔀 ProxyJump / Bastion Host — подключение к серверам за промежуточными хостами с поддержкой цепочек многоходовых соединений
📁 Файловые операции — загрузка и скачивание файлов между локальными и удаленными системами
⚡ Выполнение команд — запуск команд на удаленных серверах с поддержкой рабочей директории
📂 Директории по умолчанию — установка рабочих директорий по умолчанию для каждого сервера для удобства
🎯 Простая конфигурация — простая настройка через файл .env с помощью инструмента конфигурации

Возможности Enterprise DevOps (v3.0) 🎉

💾 Резервное копирование и восстановление — автоматизированное резервное копирование для MySQL, PostgreSQL, MongoDB и файлов
🏥 Мониторинг состояния — проверки состояния сервера в реальном времени (CPU, RAM, диск, сервисы)
🗄️ Управление базами данных — безопасные операции с БД с защитой от SQL-инъекций
📊 Управление процессами — мониторинг и управление серверными процессами
⚠️ Умные оповещения — настраиваемые пороги состояния и уведомления

Возможности v2.0

🚀 Bash CLI — молниеносный чистый Bash CLI для управления серверами
📊 Расширенное логирование — комплексная система логирования с уровнями и историей
🔄 Интеграция с Rsync — двусторонняя синхронизация файлов с поддержкой rsync
💻 Постоянные сессии — сохранение контекста оболочки между несколькими командами
👥 Группы серверов — выполнение команд на нескольких серверах одновременно
🔧 SSH-туннели — локальная/удаленная переадресация портов и поддержка SOCKS-прокси
📈 Системный мониторинг — мониторинг CPU, памяти, диска и сети в реальном времени
🏷️ Псевдонимы серверов — используйте короткие псевдонимы вместо полных имен серверов
🚀 Умное развертывание — автоматизированное развертывание файлов с обработкой прав доступа
🔑 Поддержка Sudo — безопасное выполнение команд с привилегиями sudo
📝 Поддержка OpenAI Codex — совместимость с OpenAI Codex через конфигурацию TOML

⚙️ Управление инструментами и оптимизация контекста

НОВИНКА в v3.1: Сократите использование контекста Claude Code на 92% с помощью управления активацией инструментов!

MCP SSH Manager включает 37 инструментов, организованных в 6 групп. По умолчанию все инструменты включены, но вы можете оптимизировать их под свой рабочий процесс:

Быстрая настройка

# Interactive configuration wizard
ssh-manager tools configure

# View current configuration
ssh-manager tools list

# Enable/disable specific groups
ssh-manager tools enable monitoring
ssh-manager tools disable backup

Режимы конфигурации

Режим	Инструменты	Использование контекста	Лучше всего для
Все (по умолчанию)	37 инструментов	~43.5k токенов	Полный набор функций, большинство пользователей
Минимальный	5 инструментов	~3.5k токенов	Только базовые SSH-операции
Пользовательский	5-37 инструментов	Варьируется	Адаптировано под ваш рабочий процесс

Группы инструментов

Core (5 инструментов) — всегда включены: list, execute, upload, download, sync
Sessions (4 инструмента) — постоянные SSH-сессии
Monitoring (6 инструментов) — проверки состояния, статус сервисов, управление процессами
Backup (4 инструмента) — резервное копирование баз данных и файлов
Database (4 инструмента) — операции с MySQL, PostgreSQL, MongoDB
Advanced (14 инструментов) — развертывание, sudo, туннели, группы, псевдонимы и т.д.

Преимущества

Сокращение контекста на 92% в минимальном режиме (экономия ~40k токенов)
Меньше запросов на подтверждение в Claude Code
Более быстрая загрузка и более чистый интерфейс
Экспорт конфигурации автоподтверждения для Claude Code

📖 Полное руководство по управлению инструментами →

📋 Предварительные требования

Node.js (v18 или выше)
npm (поставляется с Node.js)
Платформы: Linux, macOS, Windows
Для Claude Code: установлен Claude Code CLI
Для OpenAI Codex: настроен Codex CLI
Bash 4.0+ (для инструментов управления CLI)
rsync (для синхронизации файлов)
sshpass (опционально, для rsync с аутентификацией по паролю)
- macOS: brew install hudochenkov/sshpass/sshpass
- Linux: apt-get install sshpass

🚀 Быстрый старт - Claude Code

1. Установка MCP SSH Manager

Вариант А: Установка из npm (рекомендуется)

# Install globally from npm
npm install -g mcp-ssh-manager

# Or install locally
npx mcp-ssh-manager

Вариант Б: Установка из исходного кода

# Clone and install
git clone https://github.com/bvisible/mcp-ssh-manager.git
cd mcp-ssh-manager
npm install

# Install the Bash CLI
cd cli && ./install.sh

# Configure your first server
ssh-manager server add

2. Установка в Claude Code

# For personal use (current user only)
claude mcp add ssh-manager node /path/to/mcp-ssh-manager/src/index.js

# For team sharing (creates .mcp.json in project)
claude mcp add ssh-manager --scope project node /path/to/mcp-ssh-manager/src/index.js

# For all your projects
claude mcp add ssh-manager --scope user node /path/to/mcp-ssh-manager/src/index.js

3. Настройка автоподтверждения (опционально, но рекомендуется)

Чтобы избежать запросов на подтверждение для каждой SSH-команды, добавьте конфигурацию автоподтверждения:

Отредактируйте ~/.config/claude-code/claude_code_config.json:

{
  "mcpServers": {
    "ssh-manager": {
      "command": "node",
      "args": ["/path/to/mcp-ssh-manager/src/index.js"],
      "autoApprove": [
        "mcp__ssh-manager__ssh_execute",
        "mcp__ssh-manager__ssh_list_servers",
        "mcp__ssh-manager__ssh_upload",
        "mcp__ssh-manager__ssh_download",
        "mcp__ssh-manager__ssh_sync",
        "mcp__ssh-manager__ssh_alias"
      ]
    }
  }
}

Важно: Перезапустите Claude Code после внесения изменений.

Для полного автоподтверждения всех инструментов SSH см. полный список в examples/claude-code-config.example.json.

4. Начните использовать!

В Claude Code теперь вы можете:

"List all my SSH servers"
"Execute 'ls -la' on production server"  # Uses default directory if set
"Run 'docker ps' on staging"
"Upload config.json to production:/etc/app/config.json"
"Download logs from staging:/var/log/app.log"

**С дире

MCP SSH Manager