SSH MCP Server

Позвольте AI-клиентам безопасно управлять вашим сервером — MCP-сервер на базе SSH

Выполняйте команды и передавайте файлы на удалённых машинах через стандартизированные MCP-инструменты. Встроенные веб-консоль управления и Windows-приложение в трее.

Что он умеет

Подключите AI-клиентов, поддерживающих протокол MCP, таких как Claude Code, Cursor, к вашему SSH-серверу — и AI сможет:

• ⚙️ Выполнять команды — удалённое администрирование, разбор логов, управление сервисами

• 📤 Загружать / 📥 скачивать файлы — распространение конфигураций, загрузка логов, докачка больших файлов

• 🖥️ Управлять несколькими машинами — трёхуровневое дерево «проект → среда → хост»: настройте один раз — используйте где угодно

Два варианта использования — выбирайте под свои задачи:

Related MCP server: sshops

✨ Ключевые возможности

Подключение

• 🔐 Различные способы аутентификации: пароль / закрытый ключ (включая зашифрованный) / SSH Agent / интерактивная 2FA с клавиатуры

• 🔗 Поддержка прокси SOCKS5 и HTTP(S), проход через шлюзовые сети

• 🚄 Два режима передачи:

  • exec — отдельный канал на каждую команду, для стандартных Linux-хостов

  • shell — постоянная сессия + протокол с маркерами, для бастион-хостов / прыжковых машин

• ⏱️ Тайм-ауты трёх уровней — подключение / команда / SFTP — настраиваются независимо; большие файлы передаются через fastPut/fastGet с фрагментацией и параллелизмом

Политика безопасности

• Белый / чёрный список команд (регулярные выражения), двухуровневая фильтрация на уровне хоста и глобально

• Белые списки локальных и удалённых путей, ограничивающие область передачи файлов

• Полный журнал аудита: команды, вывод и записи о передачах можно отследить

Веб-консоль управления

• Визуальное управление иерархией «проект-среда-хост», сортировка подключений перетаскиванием

• Проверка подключения, пакетный импорт/экспорт JSON, автоматическое использование ~/.ssh/config

• Автоматические резервные копии по расписанию и восстановление в один клик; регистрация MCP-клиентов (Claude Code и др.) в один клик

• Светлая и тёмная темы, автоматически следуют за системой

Windows-приложение

• 🎯 Один exe в трее: SSH-сервис, MCP-сервер и статический сайт администрирования полностью встроены, без зависимости от Node.js

• Автозапуск при включении системы и работа в фоне до её выключения; «Открыть страницу управления» открывает браузер по умолчанию

• 🔄 Онлайн-обновление: встроенная проверка подписи minisign, автоматическое обнаружение новой версии и тихое обновление

📸 Обзор интерфейса

Управление подключениями — трёхуровневое дерево для всех хостов:

Системная страница — состояние сервисов и регистрация MCP-клиентов в один клик:

🚀 Быстрый старт

Способ 1: Windows-приложение

Скачайте SSH-MCP-Server_x.x.x_x64-setup.exe из Releases и установите. После запуска приложение остаётся в системном трее; через пункт меню «Открыть страницу управления» вы попадаете в веб-консоль.

Для уже установленных пользователей последующие обновления выполняются автоматически, без ручных действий.

Способ 2: npm-пакет (stdio MCP-сервер)

# 全局安装
npm install -g @sieop/ssh-mcp-server

Зарегистрируйте в MCP-клиенте (на примере Claude Code):

claude mcp add ssh-server -- ssh-mcp-server --host your.server.com --username root --password YOUR_PWD

Или укажите JSON-конфигурацию напрямую:

{
  "mcpServers": {
    "ssh-server": {
      "command": "npx",
      "args": ["-y", "@sieop/ssh-mcp-server", "--host", "your.server.com", "--username", "root", "--password", "YOUR_PWD"]
    }
  }
}

Также поддерживаются конфигурационные файлы и режим нескольких подключений — подробнее в docs/migration.md и справке CLI (--help).

Способ 3: сборка из исходного кода

git clone https://github.com/SIE-Operations-and-Maintenance-Team/ssh-mcp-server.git
cd ssh-mcp-server && npm install

npm run build                 # 构建 Node 版
npm test                      # 运行测试
npm --prefix admin-web install && npm --prefix admin-web run build   # 构建管理台前端
npm run tauri:build           # 构建 Windows 桌面应用（需 Rust 工具链）

🧰 Обзор MCP-инструментов

🏗️ Архитектура

┌─ Windows 桌面应用（Tauri 2 纯托盘单 exe）──────────────────┐
│                                                            │
│  SSH 连接池 ── MCP StreamableHTTP (/mcp)                   │
│      │                                                     │
│  Admin API (/admin/api/*) ── 内嵌静态站点 (/admin/)        │
│                                                            │
└────────────────── 系统默认浏览器打开管理页 ────────────────┘

Node 版（npm 包）：stdio MCP Server ＋ 可选 --admin 启动同一套 Web 管理台

Ключевые модули: src/services/ssh-connection-manager.ts (ядро SSH), src/server/ (административный сервис на Fastify), src-tauri/ (Rust-оболочка для рабочего стола), admin-web/ (консоль управления на React).

📋 Дополнительная документация

• Руководство по миграции — настройка подключения для различных клиентов

• Журнал изменений

📄 Лицензия

ISC © SIE Operations and Maintenance Team

Этот проект основан на classfang/ssh-mcp-server, реорганизован и расширен.