mcp-ssh-manager

项目简介

mcp-ssh-manager 是一个标准的 stdio MCP 服务器，用于 SSH。它让 Claude Code、Claude Desktop、OpenAI Codex 或其他 MCP 客户端执行命令、移动文件、查询数据库、创建备份、检查健康状态、打开隧道并管理服务器；控制平面可以显示实时输出，并在执行前暂停请求等待审批。

核心功能

• 以 MCP 服务器形式提供 SSH 能力，可供 Claude Code、Claude Desktop、OpenAI Codex 及其他 MCP 客户端使用。提供 37 个 SSH 工具，覆盖命令执行、文件上传下载与 rsync 同步、数据库导出导入查询、备份、健康检查、服务与进程管理、部署、会话、隧道、分组、别名、钩子和配置文件。支持按服务器设置 unrestricted、readonly 以及带允许和拒绝命令模式的 restricted 模式。包含使用 AES-256-GCM 的加密保险库，主密钥存于操作系统钥匙串（没有时使用 0600

适用场景

• 让 MCP 客户端诊断生产环境的负载、内存、磁盘或占用最高的进程。创建带时间戳和保留策略的 MySQL、PostgreSQL、MongoDB 或文件备份，并支持压缩。将文件部署到远程服务器，并处理所有权、权限、备份和重启。在一组带标签的服务器上执行同一条命令，或打开通往生产数据库的隧道。

快速开始

• npm install -g mcp-ssh-manager
• ssh-manager server add
• claude mcp add ssh-manager mcp-ssh-manager
• 重启 Claude Code 后即可开始提问。
• 使用 OpenAI Codex 时，在 ~/.codex/config.toml 中配置 MCP 服务器，并在 ~/.codex/ssh-config.toml 中定义服务器。

部署与要求

• 使用 npm/CLI 时，需要 Node 18 或更高版本，支持 Linux、macOS 或 Windows。ssh_sync 需要 rsync。仅在通过密码认证进行同步时需要 sshpass。桌面应用自带运行时和引擎，因此不需要 Node.js 或 npm。若要从源码检出使用 ssh-manager control，需先运行 npm run build:ui 构建一次界面。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。