适合谁
- 使用 Claude Code 或 OpenAI Codex 的开发人员和 DevOps 工程师
- 管理多台服务器并希望自动化日常任务的团队
- 需要快速执行命令、传输文件或监控系统的运维人员
S
52FMRS · D
此服务器提供了广泛的功能，通过 MCP 进行全面的 SSH 管理，适合需要深度自动化 DevOps 流程的团队。虽然提供了安全模式和审计日志，但用户仍需谨慎管理凭据和权限。
一个 MCP 服务器，使 Claude Code 和 OpenAI Codex 能够管理多个 SSH 连接。执行命令、传输文件、管理数据库、创建备份、监控健康状态，并直接从你的 AI 助手中自动化 DevOps 任务。
工具能力
ssh_list_servers
列出所有已配置的 SSH 服务器及其详细信息。
ssh_execute
在远程服务器上执行命令。支持指定工作目录。
ssh_upload
将文件上传到远程服务器。
ssh_download
从远程服务器下载文件。
ssh_sync
使用 rsync 在本地和远程之间双向同步文件。
ssh_deploy
自动处理权限和备份地进行文件部署。
ssh_execute_sudo
使用 sudo 权限执行命令，安全地处理密码。
ssh_alias
管理服务器别名。操作：添加、移除、列出。
ssh_command_alias
管理常用命令的别名。操作：添加、移除、列出、建议。
ssh_hooks
管理 SSH 操作的自动化钩子。操作：列出、启用、禁用、状态。
ssh_profile
管理不同项目类型的配置档案。操作：列出、切换、当前。
ssh_backup_create
在远程服务器上创建数据库或文件的备份。支持 MySQL、PostgreSQL、MongoDB 和文件系统。
ssh_backup_list
列出远程服务器上所有可用的备份。
ssh_backup_restore
从以前的备份恢复。
ssh_backup_schedule
使用 cron 调度自动备份。
ssh_health_check
在远程服务器上执行全面的健康检查（CPU、内存、磁盘、网络等）。
ssh_service_status
检查服务的状态（nginx、mysql、docker 等）。
ssh_process_manager
列出、监控或终止远程服务器上的进程。
ssh_alert_setup
配置健康监控警报和阈值。操作：设置、获取、检查。
ssh_db_dump
在远程服务器上创建数据库转储（支持 MySQL、PostgreSQL、MongoDB）。
ssh_db_import
导入 SQL 转储或恢复远程数据库。
ssh_db_list
列出远程服务器上的数据库或表。
ssh_db_query
在远程数据库上执行只读 SQL 查询（仅允许 SELECT）。
ssh_connection_status
检查 SSH 连接状态，并强制重新连接。
ssh_tunnel_create
创建 SSH 隧道（本地/远程端口转发或 SOCKS 代理）。
ssh_tunnel_list
列出活动 SSH 隧道。
ssh_tunnel_close
关闭 SSH 隧道。
ssh_session_start
开始一个持久的 SSH 会话。
ssh_session_exec
在持久会话中执行命令。
ssh_session_end
结束持久 SSH 会话。
ssh_group_execute
在多个服务器上同时执行命令。
ssh_monitor
实时监控 CPU、内存、磁盘和网络。
ssh_tail
跟踪远程文件末尾。
ssh_disk_usage
检查磁盘使用情况。
ssh_network_stats
获取网络统计信息。
ssh_uptime
获取远程服务器的运行时间。
安装接入
- 安装 Node.js v18 或更高版本，并全局安装 npm 包：npm install -g mcp-ssh-manager。2. 为 Claude Code 添加 MCP 服务器：claude mcp add ssh-manager node /path/to/mcp-ssh-manager/src/index.js。3. 对于 OpenAI Codex，运行 ssh-manager codex setup 并按照提示配置 TOML 服务器配置。4. 配置服务器，使用 .env 或 TOML 格式（使用 ssh-manager server add 向导或手动编辑配置文件）。5. 如果使用某些功能，请安装可选依赖项：rsync（文件同步）、sshpass（rsync 密码认证）。
选型与风险
不适合谁
- 非技术用户，因为他们需要 SSH 和命令行的基础知识
- 对安全要求非常严格的环境，如果配置不当，暴露 SSH 凭据可能存在风险
- 需要在每个服务器上安装代理的用例，因为该服务器直接使用 SSH
所需权限
- 对本地 SSH 配置和凭据（密码、密钥、ssh-agent）的访问
- 能够执行远程命令、传输文件、管理数据库和备份
- 能够创建 SSH 隧道和持久会话
- 能够读取和修改本地的 .env 和 TOML 配置文件
风险与副作用
- 凭据在配置文件中可能以明文形式存储，如果配置文件泄露，可能会导致安全漏洞
- 通过 ssh_execute 执行任意命令可能造成意外更改或损坏
- 如果使用权限过大，SSH 代理转发可能会将本地密钥暴露给远程主机
- 网络连接不稳定可能导致命令执行超时或失败
常见排障
- 如果 MCP 工具不可用，请检查 MCP 是否已安装并重启客户端
- 如果连接失败，请使用 ssh-manager server test [server_name] 测试连接，检查网络、防火墙和 SSH 服务
- 如果权限被拒绝，请验证用户名和凭据，检查 SSH 密钥权限（chmod 600）
- 如果输出过大导致客户端挂起，请设置 MCP_SSH_MAX_OUTPUT_LENGTH 或使用 tail/grep 限制输出
- 对于 Windows 主机，请确保在配置中设置 platform=windows 以避免命令包装问题
使用场景
通过 AI 助手远程管理多台服务器
自动化 DevOps 任务，如部署和备份
监控服务器健康和性能
执行数据库操作和安全管理
通过 AI 创建和使用 SSH 隧道
支持客户端
Claude Code完整支持
OpenAI Codex完整支持