Skip to main content
Glama
honwee

SSH MCP Server

by honwee
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

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 全面检查

Related MCP server: Simple SSH MCP Server

安装

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

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/honwee/ssh-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server