MCP 服务器

SSH MCP Server

Enables AI tools to manage SSH connections, execute commands, transfer files, and perform remote server diagnostics via MCP protocol.

README

SSH MCP Server

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

功能

Tool	说明
`ssh_connect`	建立 SSH 连接（支持跳板机）
`ssh_disconnect`	断开连接
`ssh_exec`	执行单条命令
`ssh_exec_script`	执行多行脚本
`sftp_read`	读取远程文件
`sftp_write`	写入远程文件
`sftp_list`	列出远程目录
`ssh_status`	查看所有连接状态
`ssh_history`	查询操作历史日志
`ssh_analyze`	一键诊断远程服务器
`ssh_logs`	日志查询与增量监控（file/journalctl/docker）
`ssh_host_add`	保存服务器配置（支持备注和标签）
`ssh_host_remove`	删除已保存的服务器
`ssh_host_list`	列出所有已保存的服务器
`ssh_host_update`	更新服务器备注/标签（AI 知识积累）

核心特性

连接池管理 — 持久化连接，避免重复建连
跳板机支持 — 通过 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"
)