ssh-utils

ssh-utils

用途

ssh-utils 是一个模型上下文协议（MCP）服务，可让你通过 SSH 在远程服务上执行终端命令。它旨在作为工具供 Roo Code 或任何兼容 MCP 的客户端使用，从而在开发环境中安全地通过密钥执行 SSH 命令。

工作原理

• 该服务通过 MCP 协议公开名为 execute_ssh_command 的工具。
• 调用该工具时，它会通过 SSH 连接到远程服务并运行指定的命令。
• 凭据和连接详情从配置文件（ssh-utils-servers.json）中加载，该文件可放置在以下位置：
  • 当前工作目录
  • 工作区根目录
  • 全局配置目录：~/.config/ssh-utils/ssh-utils-servers.json
• 如果配置中有多个配置档，默认使用第一个，也可以按名称指定配置档。
• 任何工具参数（例如用户、主机或服务）都会覆盖配置文件中的值。

配置文件

配置文件是名为 ssh-utils-servers.json 的 JSON 文件，结构如下：

{
  "profiles": {
    "default": {
      "host": "example.com",
      "user": "bob",
      "port": 22,
      "privateKeyPath": "/home/bob/.ssh/id_ed25519"
    },
    "work": {
      "server": "workhost",
      "user": "alice"
    }
  }
}

• host 或 server：SSH 主机名或 IP 地址。
• user：SSH 用户名。
• port：（可选）SSH 端口（默认值：22）。
• privateKeyPath：（可选）私钥文件的路径。

用法

1. 将 ssh-utils-servers.json 配置文件放在受支持的位置之一。
2. 在 Roo Code 或其他 MCP 客户端中使用 execute_ssh_command 工具，指定命令，并可选择覆盖任何连接参数。

安全性

• 出于安全原因，明确禁止使用基于密码的 SSH 身份验证。仅支持基于密钥的身份验证。