ssh-mcp-helper

ssh-mcp-helper

概述

帮助用户通过交互式问答完成 @keysqiu/ssh-mcp-server 的安装预检与 MCP 客户端配置。技能本身不代替用户输入凭据，而是逐项确认认证方式、连接参数与安全策略，最终产出可直接写入 MCP 客户端配置文件的 mcpServers JSON 片段。

核心准则： 所有可枚举的选项（MCP 客户端类型、认证方式、传输模式、是/否开关）必须使用 AskUserQuestion 让用户选择；只有不可枚举的输入（host、用户名、私钥路径、密码、自定义白名单正则等）才允许自由文本提问。

何时使用

• 用户明确要安装/配置/新增 ssh-mcp-server
• 用户提到为 Cursor / Claude Code / Cline / Continue 等客户端添加 SSH MCP
• 用户希望在已有 mcpServers 中追加一台 SSH 主机
• 用户问「ssh-mcp-server 的 mcp.json 怎么写」

何时不使用

• 用户要修改 ssh-mcp-server 源码 → 直接编辑代码，不进入向导
• 用户只是想跑某条 SSH 命令 → 直接调用已存在的 ssh-mcp-server 工具
• 用户在问 SSH 协议本身的概念 → 解释即可，无需走流程

工作流程

digraph ssh_mcp_helper {
    "0. 前置环境检查" [shape=box];
    "1. 选择 MCP 客户端" [shape=box];
    "2. 单台 vs 多台" [shape=diamond];
    "3. 选择认证方式" [shape=box];
    "4. 询问连接参数" [shape=box];
    "5. 询问高级选项" [shape=box];
    "6. 生成 JSON 片段" [shape=box];
    "7. 合并写入配置" [shape=box];
    "8. 提示重启与验证" [shape=doublecircle];

    "0. 前置环境检查" -> "1. 选择 MCP 客户端";
    "1. 选择 MCP 客户端" -> "2. 单台 vs 多台";
    "2. 单台 vs 多台" -> "3. 选择认证方式" [label="单台"];
    "2. 单台 vs 多台" -> "3. 选择认证方式" [label="多台 → 写 ssh-config.json"];
    "3. 选择认证方式" -> "4. 询问连接参数";
    "4. 询问连接参数" -> "5. 询问高级选项";
    "5. 询问高级选项" -> "6. 生成 JSON 片段";
    "6. 生成 JSON 片段" -> "7. 合并写入配置";
    "7. 合并写入配置" -> "8. 提示重启与验证";
}

Step 0：前置环境检查

• 先确认目标形态：若用户已安装 Windows 桌面应用（托盘常驻 + Web 管理台），不要走本向导——引导其打开管理台，用「系统 → 一键注册」把客户端指向 http://127.0.0.1:61823/mcp；主机在管理台维护，凭据无需写进客户端配置
• 本向导面向 CLI / npm 形态：运行 node -v 与 npm -v 确认本机有 Node.js（推荐 v18+）
• 缺失则先提示用户安装 Node.js，再继续后续步骤
• 安装方式用 npm install -g @keysqiu/ssh-mcp-server（不要用 npx：每次启动都要访问 npm registry 解析版本，内网 / 弱网易失败）

Step 1：选择 MCP 客户端（AskUserQuestion 多选一）

客户端	默认配置位置
Claude Code（全局）	~/.claude.json 的 mcpServers 字段
Claude Code（项目级）	项目根 .mcp.json
Cursor	~/.cursor/mcp.json
Cline / Continue / 其他	让用户提供具体路径

Step 2：单台 vs 多台（AskUserQuestion 二选一）

• 单台：直接使用命令行参数（--host 等）
• 多台：生成 ssh-config.json 并使用 --config-file