STARWARCLOUD STARWAR.AI
返回市场
ssh-mcp

ssh-mcp

作者：mertcankaraoglu12 星标更新：2025-10-24
安装使用来源：spider==github.com

项目介绍

SSH MCP 服务器 🚀

从您的 Windows 计算机使用自然语言管理您的 Ubuntu/Linux 服务器！此 MCP（模型上下文协议）服务器允许您通过 Claude Desktop 或 Cursor IDE 建立 SSH 连接来对话控制远程服务器。

TR: Windows 计算机上管理 Ubuntu/Linux 服务器！此 MCP（模型上下文协议）服务器允许您通过 Claude Desktop 或 Cursor IDE 建立 SSH 连接来对话控制远程服务器。

🎯 为什么这个项目？

与传统的 SSH 管理相比，您可以简单地告诉您的 AI 助手“连接到我的 Ubuntu 服务器并显示磁盘使用情况”。借助 MCP 协议，AI 会为您执行 SSH 命令，并实时呈现结果。

✨ 特性

  • 🔐 安全的 SSH 连接 - 基于密码的身份验证
  • ⚡ 实时输出 - 即时查看命令输出
  • 🤖 AI 集成 - 支持 Claude Desktop 和 Cursor IDE
  • 🎨 自然语言控制 - 通过说话执行命令
  • 📦 最小安装 - 只需 3 个工具，零复杂度

📋 要求

  • Node.js v18 或更高版本 (下载)
  • Claude Desktop (下载)
  • 具有 SSH 访问权限的 Linux/Ubuntu 服务器

Node.js 安装

Windows:

  1. 从nodejs.org下载 LTS 版本
  2. 运行下载的 .msi 文件
  3. 安装完成后打开终端并输入 node --version

macOS:

# 使用 Homebrew
brew install node

# 或者从官方站点下载

Linux (Ubuntu/Debian):

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

🚀 安装

自动安装（推荐） ⭐

只需在配置文件中添加以下内容：

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "-y",
        "git+https://github.com/mertcankaraoglu/ssh-mcp.git#main"
      ]
    }
  }
}

要求：

  • Node.js v18+ (下载)
  • Claude Desktop 或 Cursor IDE

手动安装

1. 下载项目

git clone https://github.com/mertcankaraoglu/ssh-mcp.git
cd ssh-mcp

2. 安装依赖项

npm install

3. 连接 MCP

根据您使用的应用程序，遵循以下步骤：

🖥️ 对于 Claude Desktop

Windows:

打开 %APPDATA%\Claude\claude_desktop_config.json 并添加：

{
  "mcpServers": {
    "ssh": {
      "command": "node",
      "args": ["C:\\Users\\KULLANICI_ADINIZ\\ssh-mcp\\index.js"]
    }
  }
}

macOS/Linux:

打开 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "ssh": {
      "command": "node",
      "args": ["/tam/yol/ssh-mcp/index.js"]
    }
  }
}

🎯 对于 Cursor IDE

Windows:

打开 %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json：

{
  "mcpServers": {
    "ssh": {
      "command": "node",
      "args": ["C:\\Users\\KULLANICI_ADINIZ\\ssh-mcp\\index.js"]
    }
  }
}

macOS/Linux:

~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json：

{
  "mcpServers": {
    "ssh": {
      "command": "node",
      "args": ["/tam/yol/ssh-mcp/index.js"]
    }
  }
}

4. 重新启动应用程序

关闭并重新打开 Claude Desktop 或 Cursor。MCP 服务器将自动启动。

5. 测试安装

在 Claude Desktop 中尝试以下命令：

"测试 SSH 连接 - 连接到 IP 地址为 192.168.1.100 的服务器"

如果 MCP 服务器正在运行，Claude 将询问您 SSH 连接参数。

💡 使用

可用工具

工具描述
ssh_connect建立到服务器的 SSH 连接
ssh_exec在远程服务器上执行命令
ssh_disconnect关闭 SSH 连接

示例对话

连接：

您: "连接到我位于 192.168.1.100 的 Ubuntu 服务器。用户名：ubuntu，密码：mypassword"
Claude: [使用 ssh_connect 工具连接]

执行命令：

您: "显示磁盘使用情况"
Claude: [通过 ssh_exec 执行 'df -h' 命令]

您: "显示最后 10 条系统日志"
Claude: [通过 ssh_exec 执行 'tail -n 10 /var/log/syslog']

您: "列出 Docker 容器"
Claude: [通过 ssh_exec 执行 'docker ps']

断开连接：

您: "关闭 SSH 连接"
Claude: [使用 ssh_disconnect 工具]

🔧 技术细节

使用的技术

架构

┌─────────────────┐
│ Claude/Cursor   │
│   (AI 客户端)   │
└────────┬────────┘
         │ MCP 协议
         │ (stdio)
┌────────▼────────┐
│  MCP SSH 服务器 │
│  (本项目)       │
└────────┬────────┘
         │ SSH2
         │
┌────────▼────────┐
│ Ubuntu 服务器   │
└─────────────────┘

🛡️ 安全注意事项

  • ⚠️ 密码不会以明文形式存储在配置文件中，仅在运行时使用
  • 🔒 SSH 连接使用标准的 SSH2 协议进行加密
  • 💡 推荐在生产环境中使用基于 SSH 密钥的身份验证（将在未来版本中添加）

🗺️ 发展路线图

  • SSH 密钥支持
  • 多服务器管理
  • SFTP 文件传输
  • 端口转发
  • 会话保存/加载

🤝 贡献

我们欢迎您的贡献！请随意发送拉取请求。

  1. 分叉它
  2. 创建您的功能分支 (git checkout -b feature/amazing)
  3. 提交您的更改 (git commit -m 'feat: 添加精彩功能')
  4. 推送到分支 (git push origin feature/amazing)
  5. 打开一个拉取请求

📝 许可证

MIT 许可证 - 查看LICENSE文件获取详情。

🙏 致谢

⭐ 如果您喜欢这个项目，请不要忘记给它点赞！