Claude Ssh Server

Claude SSH 服务器

直接使用IP/用户名/密码建立SSH连接 - 无需配置！

这款MCP服务器使Claude能够仅通过IP地址、用户名和密码，按需连接到任何SSH服务器。无需SSH配置文件！

🚀 关键特性

与传统的SSH MCP服务器不同，后者需要预先配置主机 ~/.ssh/config，Claude SSH 服务器支持 临时连接 在每次请求中直接传递凭据。

📦 安装

NPM 全局安装

npm install -g claude-ssh-server

本地安装

cd claude-ssh-server
npm install
npm run build

🔧 配置

克劳德桌面版

添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "claude-ssh": {
      "command": "npx",
      "args": [
        "-y",
        "claude-ssh-server"
      ]
    }
  }
}

🎯 使用方法

直接连接（新功能！）

无需预先配置即可连接到任何SSH服务器：

{
  "tool": "direct_exec",
  "host": "10.100.100.53",
  "username": "mtusa",
  "password": "your-password",
  "command": "ls -la",
  "port": 22,  // optional, defaults to 22
  "timeout": 60000  // optional, defaults to 60000ms
}

传统的命令行界面（CLI）模式

你仍然可以使用带有CLI参数的传统模式：

claude-ssh-server --host=10.100.100.53 --user=mtusa --password=mypass

然后使用 exec 工具（从命令行参数中获取凭证）。

🛠️ 可用工具

direct_exec （推荐）

根据每次请求提供的凭据执行命令：

• 主机SSH服务器IP或主机名
• 用户名SSH 用户名
• 密码SSH 密码（如果使用私钥则可选）
• 私钥SSH私钥内容（如果使用密码则此步骤可选）
• 命令执行命令
• 港口SSH 端口（默认：22）
• 超时超时时间（毫秒）（默认：60000）

exec （遗留的/传统）

使用通过CLI配置的凭据执行命令：

• 命令执行命令

🔒 安全注意事项

• 凭据是按请求传递的，不会存储
• 支持密码和私钥两种认证方式
• 连接超时保护（默认60秒）
• 命令净化与验证
• 无持久连接或凭证存储

📝 示例

检查远程服务器上的磁盘空间

{
  "tool": "direct_exec",
  "host": "192.168.1.100",
  "username": "admin",
  "password": "secure-password",
  "command": "df -h"
}

运行多个命令

{
  "tool": "direct_exec",
  "host": "server.example.com",
  "username": "devops",
  "password": "password123",
  "command": "cd /var/log && tail -n 50 syslog"
}

使用SSH密钥

{
  "tool": "direct_exec",
  "host": "prod-server",
  "username": "deploy",
  "privateKey": "-----BEGIN RSA PRIVATE KEY-----\n...",
  "command": "systemctl status nginx"
}

🤝 致谢

从……分叉 tufantunc/ssh-mcp 翻译为中文是“tufantunc/SSH-MCP”（这里保持原名不变，因为“ssh-mcp”是一个特定的项目或工具名，直接翻译可能无法准确传达其含义，所以保留原样）。如果非要对“ssh-mcp”进行解释性翻译，可以是“基于SSH的MCP（可能指某种管理或控制协议）”，但具体含义需根据上下文确定。因此，最准确的翻译还是“tufantunc/SSH-MCP”

由Jason Smith修改，以添加对Claude桌面版集成的直接连接支持。

📄 许可证

MIT 许可证 - 详见 LICENSE 文件

🐞 问题与贡献

报告问题：https://github.com/jasondsmith72/claude-ssh-server/issues

欢迎提交拉取请求！