embedded-mcp-toolkit: Skill for Claude Code

配置 file_utils_remote 远程文件 MCP

核心思路

两层 SSH 各司其职：用嵌入式 MCP（ssh_shell_login，密码登录，带 PTY）一次性引导配好密钥免密 + 顺带查 bin 路径；之后系统 ssh（密钥免密，无 PTY）才是 MCP client 的长期通道。MCP client spawn ssh 时不分配 PTY、stdin/stdout 被 JSON-RPC 占用，无法交互输密码，必须提前配好免密。

动态值收集

全流程收集以下值，第六步写配置时一次性替换占位符，之前各步只拿值不写配置：

• <USER>@<HOST>：第一步从 device_info_tool 解析（连接目标）。
• <BIN_DIR_REL>：第四步从嵌入式 session（带 PTY）查到的 bin 目录相对家目录的路径，如 .npm-global/bin。
• <INSTALL_FAILED>：第四步安装失败时置 true（初始 false），用于第七步末尾提示。

专用密钥路径固定 ~/.ssh/id_file_utils_remote（非动态值）。

步骤

第一步：解析设备连接信息

设备名 $device 由框架参数替换注入。若仍是占位符（用户未带参数），调 device_info_tool（device: "all"）列出全部并询问。

调 device_info_tool（device: "$device"）取 SSH 配置，记录 <HOST>（ssh.host）、<USER>（ssh.username），派生 <USER>@<HOST>。

第二步：检查本地密钥对（无则生成）

ls ~/.ssh/id_file_utils_remote ~/.ssh/id_file_utils_remote.pub 2>/dev/null

• 已存在 → 复用，绝不覆盖（会破坏已配好的免密信任）。不存在 → 生成（passphrase 留空）：

ssh-keygen -t ed25519 -f ~/.ssh/id_file_utils_remote -N "" -C "file-utils-remote"

读取公钥内容备用（cat ~/.ssh/id_file_utils_remote.pub）。

第三步：用嵌入式 MCP 登录 $device

调 ssh_shell_login（device: "$device", timeout: 30），取 session_id。

此 session 带 PTY，PATH 已加载全局 bin——第四步要趁它开着查 bin 路径，关闭后用系统 ssh 无 PTY 查会落空。

第四步：推送公钥 + 查 bin 路径（同一 session）

先推送公钥（ssh_shell_exec，<PUBKEY> 替换为第二步读到的公钥，单引号包裹）：

mkdir -p ~/.ssh && chmod 700 ~/.ssh && echo '<PUBKEY>' >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys && sort -u ~/.ssh/authorized_keys -o ~/.ssh/authorized_keys && echo PUBKEY_OK

查 bin 路径（同一 session）：

which file-utils-mcp-toolkit; echo "---"; echo $HOME

• which 命中 → bin 路径去掉文件名、再去掉 $HOME 前缀，得 <BIN_DIR_REL>（如 .npm-global/bin）；bin 不在家目录下则用绝对目录。
• which 无输出 → 远端未安装，走 4a/4b，装完重查。

第四步分支：远端未安装时自动安装（不中断）

优先用本地离线包（SFTP 上传 + offline_install.sh），离线包不存在才 npm i -g 在线兜底。安装失败只记 <INSTALL_FAILED>=true、不中断——免密与配置不依赖远端是否已装好，第五~七步照走。

离线包路径（固定）：.embedded/file-utils-mcp-toolkit-1.0.0-linux-x64-offline.tar.gz。