ssh-operator-mcp

功能

• 枚举和诊断 Windows OpenSSH 配置中的具体主机别名。

• 执行远端命令，或通过标准输入发送 Bash/POSIX shell 脚本。

• 显式选择默认、登录或交互 shell，并以不回显值的方式设置或清除远端环境变量。

• 分页列出远端目录树、搜索文本，并探测登录环境差异。

• 带文件哈希并发保护地读取、补丁编辑或原子写入远端文本。

• 查询、哈希、上传、原子上传和下载单个文件；覆盖默认关闭。

• 启动、读取、停止和关闭受管远端进程。

• 可选持久化进程日志，并在异常退出后执行带身份校验的恢复。

• 使用 ssh_sudo_probe 被动检查免密 sudo；仅通过显式工具执行非交互提权。

• 注册生命周期与插件一致的 ssh-operator Skill，指导模型安全组合 MCP 工具。

• 插件列表中的名称和简介随 DSH 的中文或英文界面切换。

插件通过 DSH 官方 @deepseek-ai/dsh-mcp-client 暴露 30 个 mcp__ssh_operator__* 工具。内置服务直接以 shell: false 启动系统 OpenSSH，远端脚本不会经过 PowerShell 引号层。

Related MCP server: ssh-for-agents

兼容性

• 面向 DSH 0.2 系列；实际验证版本和覆盖范围见对应 GitHub Release。

• 运行时要求 Node.js 24 或更高版本；本地开发使用 pnpm 11.19。

• 当前控制端面向 Windows，需要系统 ssh.exe 和 scp.exe。

• %USERPROFILE%\.ssh\config 中应已有具体主机别名，并完成密钥与主机指纹配置。

• SSH 连接必须能在 BatchMode=yes 下非交互工作。

安装

从 GitHub Release 安装

从 v0.2.2 下载以下文件，无需解压：

dsh-ssh-operator-0.2.2.tgz
SHA256SUMS.txt

核对 SHA-256 后安装版本化归档：

Get-FileHash -Algorithm SHA256 "C:\Downloads\dsh-ssh-operator-0.2.2.tgz"
dsh plugin --profile web add "C:\Downloads\dsh-ssh-operator-0.2.2.tgz"

从源码目录安装

cd "D:\CodeSpace\personal\DSH_Plugin\dsh-ssh-operator"
pnpm install --frozen-lockfile
pnpm run check
dsh plugin --profile web add "D:\CodeSpace\personal\DSH_Plugin\dsh-ssh-operator"

安装后完全退出并重新启动 DSH。工具目录应出现 mcp__ssh_operator__ssh_list_hosts 等工具，Skill 目录应出现 ssh-operator。

配置

serverName 定义公开工具命名空间，修改后会改变全部 mcp__ssh_operator__* 工具名，因此不建议作为日常设置开放。toolCallTimeoutMs 和 failOnStartupError 更适合作为高级设置；后者开启后，MCP 启动错误可能阻止整个 DSH profile 启动。

配置变化和链接源码更新均需重启 DSH 才能可靠生效。MCP 断开后的重连由 DSH 官方 MCP 客户端管理。

安全边界

• 主机参数只能是 SSH 配置中的具体别名，不能作为任意本地 shell 片段。

• 本地程序直接启动，不调用 PowerShell、cmd.exe 或其他本地命令 shell。

• 插件不保存 SSH 密码、私钥或完整 SSH 配置。

• 上传和下载默认拒绝覆盖；原子上传先校验 SHA-256，再在同目录发布。

• 文本补丁要求调用方提供读取时的 SHA-256；并发变化会拒绝提交。相同 operationId 仅能重试完全相同的操作。

• 环境探测只返回变量名和噪声指纹，不返回代理值；交互 shell 可能执行远端启动文件副作用，必须显式选择。

• 超时、取消、传输失败和远端退出分别报告。

• 持久日志是明文，可能包含敏感输出；仅在确有需要时启用并显式删除。

• 恢复清理会校验远端进程身份 token，不按 PID 强制误杀。

• sudo 工具固定使用 sudo -n，不接受或传输密码，也不会修改远端 sudoers；普通工具始终保持非特权。

内置运行时同步自 ssh-operator-mcp v0.18.2（提交 fb5eecc6df4728e83a96f37bd38f865a5350ec4f）。凡工具 schema 中出现 host，模型必须在每次调用时显式传入具体别名，不能依赖对话上下文推断；本地诊断模式的 ssh_doctor 以及不声明 host 的进程、日志和恢复工具除外。

开发

pnpm install --frozen-lockfile
pnpm peers check
pnpm run check
pnpm run release:prepare -- v0.2.2

维护说明见 架构、测试和发布文档。

卸载

dsh plugin --profile web remove dsh-ssh-operator

卸载会同时移除 Bundle、内嵌 Skill 和 MCP 工具。插件不创建凭据文件；已选择持久化的进程日志和恢复状态会保留，手工清理前应先确认内容是否仍有价值。

许可证

本项目采用 MIT 许可证。内置 SSH Operator MCP 为本项目维护的独立实现；其设计参考来源见相关源码说明。