SSH MCP Server

Permite a los clientes de IA operar tu servidor de forma segura — un servidor MCP basado en SSH

Ejecuta comandos y transfiere archivos en remoto a través de herramientas MCP estandarizadas, e incluye una consola de administración web y una aplicación de bandeja para Windows.

Qué puede hacer

Conecta clientes de IA compatibles con el protocolo MCP, como Claude Code y Cursor, a tu servidor SSH, y la IA podrá:

• ⚙️ Ejecutar comandos — operación y mantenimiento remotos, diagnóstico de logs, gestión de servicios

• 📤 Subir / 📥 descargar archivos — distribución de configuraciones, extracción de logs, reanudación de transferencias de archivos grandes

• 🖥️ Gestión de múltiples máquinas — árbol de tres niveles: proyecto → entorno → host; configura una vez y úsalo en todas partes

Dos modalidades de uso, elige según tus necesidades:

Related MCP server: sshops

✨ Características principales

Capacidades de conexión

• 🔐 Varias autenticaciones: contraseña / clave privada (incluidas las cifradas) / SSH Agent / 2FA por teclado interactivo

• 🔗 Proxies SOCKS5 y HTTP(S) para atravesar redes de salto

• 🚄 Doble modo de transporte:

  • exec — un canal por comando, hosts Linux estándar

  • shell — sesión persistente + protocolo de marcado, adecuado para bastiones / servidores de salto

• ⏱️ Tiempos de espera (conexión / comando / SFTP) configurables de forma independiente; los archivos grandes usan fastPut/fastGet con división en fragmentos y concurrencia

Políticas de seguridad

• Listas blancas / negras de comandos (expresiones regulares), filtrado de doble capa a nivel de host y global

• Listas blancas de rutas locales y remotas para limitar el alcance de la transferencia de archivos

• Registros de auditoría completos: comandos, salidas y registros de transferencia trazables

Consola de administración web

• Gestión visual de tres niveles (proyecto, entorno y host), conexiones ordenables por arrastrar y soltar

• Prueba de conexión, importación/exportación masiva JSON, reutilización automática de ~/.ssh/config

• Copias de seguridad programadas con instantáneas y restauración con un clic; registro con un clic para clientes MCP (como Claude Code)

• Temas claro y oscuro, que siguen al sistema

Aplicación de escritorio para Windows

• 🎯 Un solo exe residente en la bandeja: servicio SSH, servidor MCP y sitio estático de administración integrados, sin dependencia de Node.js

• Inicio automático al encender, permanencia al apagar; «Abrir página de administración» abre el navegador predeterminado del sistema

• 🔄 Autoactualización en línea: verificación de firma integrada con minisign, detección automática de nuevas versiones y actualización silenciosa

📸 Vista de la interfaz

Gestión de conexiones — árbol de tres niveles para administrar todos los hosts:

Página del sistema — estado del servicio y registro de clientes MCP con un clic:

🚀 Inicio rápido

Opción 1: Aplicación de escritorio para Windows

Descarga e instala SSH-MCP-Server_x.x.x_x64-setup.exe desde Releases. Tras iniciarla, permanecerá en la bandeja del sistema; en el menú de la bandeja, «Abrir página de administración» te lleva a la consola web.

Las actualizaciones posteriores para usuarios ya instalados se completan automáticamente, sin necesidad de intervención manual.

Opción 2: Paquete npm (servidor MCP stdio)

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

Regístralo en tu cliente MCP (por ejemplo, Claude Code):

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

O escribe directamente la configuración JSON:

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

También admite archivos de configuración y modo de múltiples conexiones; consulta docs/migration.md y la ayuda de la CLI (--help).

Opción 3: Compilar desde el código fuente

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 工具链）

🧰 Resumen de herramientas MCP

🏗️ Arquitectura

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

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

Módulos clave: src/services/ssh-connection-manager.ts (núcleo SSH), src/server/ (servicio de administración Fastify), src-tauri/ (carcasa de escritorio en Rust), admin-web/ (consola de administración en React).

📋 Más documentación

• Guía de uso y migración — configuración de integración para cada cliente

• Registro de cambios

📄 Licencia

ISC © SIE Operations and Maintenance Team

Este proyecto se origina a partir de classfang/ssh-mcp-server, sobre el cual se ha reestructurado y ampliado.