SSH MCP Server

高效的 SSH 远程运维 MCP 服务。让 AI 工具通过 MCP 协议管理 SSH 连接、执行命令、传输文件。

功能

核心特性

• 连接池管理 — 持久化连接，避免重复建连
• 跳板机支持 — 通过 jump host 连接内网服务器
• 多认证方式 — 密码 / 私钥
• SFTP 文件操作 — 读写文件、浏览目录
• 空闲超时清理 — 30 分钟无活动自动断开
• 多行脚本执行 — 通过 bash -s 执行复杂脚本
• 持久化操作日志 — 所有操作记录到 ~/.ssh-mcp/logs/operations.jsonl，支持 AI 溯源
• 一键服务器诊断 — 系统信息、资源、网络、Docker、GPU 全面检查

安装

npm install -g @honwee/ssh-mcp-server

或者直接通过 npx 使用（无需全局安装）：

npx @honwee/ssh-mcp-server

配置

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": ["-y", "@honwee/ssh-mcp-server"]
    }
  }
}

Cursor

在 Cursor Settings → MCP 中添加：

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": ["-y", "@honwee/ssh-mcp-server"]
    }
  }
}

Gemini CLI / Antigravity

在 settings.json 中添加：

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": ["-y", "@honwee/ssh-mcp-server"]
    }
  }
}

使用示例

直连服务器

1. ssh_connect(host="192.168.1.100", username="root", password="xxx", alias="web-server")
2. ssh_exec(connectionId="web-server", command="uptime")
3. ssh_exec(connectionId="web-server", command="df -h")
4. sftp_list(connectionId="web-server", remotePath="/var/log")
5. sftp_read(connectionId="web-server", remotePath="/etc/nginx/nginx.conf")
6. ssh_disconnect(connectionId="web-server")

通过跳板机连接

ssh_connect(
  host="10.0.0.50",
  username="deploy",
  privateKey="-----BEGIN OPENSSH PRIVATE KEY-----\n...",
  alias="internal-db",
  jumpHost={
    host="bastion.example.com",
    username="admin",
    password="xxx"
  }
)

执行多行脚本

ssh_exec_script(
  connectionId="web-server",
  script="#!/bin/bash\necho '--- Disk Usage ---'\ndf -h\necho '--- Memory ---'\nfree -h\necho '--- Top Processes ---'\nps aux --sort=-%mem | head -10"
)

License

MIT