🔐 SSH-MCP-Server 中文文档

📝 项目概述

ssh-mcp-server 是一个桥梁工具，允许 AI 助手和其他支持 MCP 协议的应用程序通过标准化接口远程执行 SSH 命令。这使得 AI 助手能够在不直接暴露 SSH 凭证的情况下安全地操作远程服务器、执行命令并获取结果。

✨ 核心功能

• 🔒 安全连接：支持多种安全的 SSH 连接方式，包括密码认证和私钥认证（带有密钥短语支持）
• 🛡️ 命令安全控制：通过灵活的黑名单和白名单机制精确控制允许执行的命令范围，防止危险操作
• 🔄 标准化接口：符合 MCP 协议规范，无缝集成支持该协议的 AI 助手
• 📂 文件传输：支持双向文件传输，可上传本地文件到服务器或从服务器下载文件
• 🔑 凭证隔离：SSH 凭证完全本地管理，从未暴露给 AI 模型，增强安全性
• 🚀 即用即取：无需全局安装，直接使用 NPX 运行即可快速部署

📦 开源仓库

GitHub: https://github.com/classfang/ssh-mcp-server

NPM: https://www.npmjs.com/package/@fangjunjie/ssh-mcp-server

🛠️ 工具列表

📚 使用说明

MCP 配置示例

命令行选项

以下是可通过命令行指定的关键参数：

• --host 或 -h：SSH 服务端的主机地址（默认值为 localhost）
• --port 或 -p：SSH 服务端的端口号（默认值为 22）
• --user 或 -u：SSH 连接的用户名
• --password 或 -P：SSH 连接的密码（不推荐使用，建议优先配置密钥认证）
• --private-key 或 -k：用于 SSH 认证的私钥路径
• --passphrase 或 -w：私钥的密钥短语
• --command-whitelist 或 -w：允许执行的命令白名单（支持正则表达式）
• --command-blacklist 或 -b：禁止执行的命令黑名单（支持正则表达式）

配置示例

使用密码认证的配置示例

{
  "command": "npx",
  "args": [
    "--host",
    "192.168.1.100",
    "--port",
    "22",
    "--user",
    "root",
    "--password",
    "your_password_here"
  ]
}

使用私钥认证的配置示例

{
  "command": "npx",
  "args": [
    "--host",
    "192.168.1.100",
    "--port",
    "22",
    "--user",
    "root",
    "--private-key",
    "/path/to/private_key.pem",
    "--passphrase",
    "your_passphrase_here"
  ]
}

使用命令白名单的配置示例

{
  "command": "npx",
  "args": [
    "--host",
    "192.168.1.100",
    "--port",
    "22",
    "--user",
    "root",
    "--password",
    "your_password_here",
    "--command-whitelist",
    "^ls$|^pwd$"
  ]
}

使用命令黑名单的配置示例

{
  "command": "npx",
  "args": [
    "--host",
    "192.168.1.100",
    "--port",
    "22",
    "--user",
    "root",
    "--password",
    "your_password_here",
    "--command-blacklist",
    "^rm .*"
  ]
}

注意：如果同时指定白名单和黑名单，系统将首先检查命令是否在白名单中，然后检查是否在黑名单中。只有通过两者的检查，命令才会被执行。