MCP SSH 服务器

一个强大的用于模型上下文协议 (MCP) 的 SSH 服务器实现。该服务器通过 SSH 协议实现安全的远程命令执行和文件操作，支持密码和密钥两种身份验证方式。

特性

• ✨ 安全的 SSH 连接管理
• 🔑 密码和密钥身份验证
• 💻 远程命令执行
• 📁 文件操作（上传/下载）
• 📊 文件传输进度跟踪
• 🔐 权限管理
• 📂 目录操作
• 🚀 批量文件传输
• 📝 详细日志记录

安装

1. 安装包：

npm install mcp-ssh

2. 添加到你的 Claude 桌面配置 (claude_desktop_config.json):

{
  "mcpServers": {
    "ssh": {
      "command": "node",
      "args": ["%APPDATA%/npm/node_modules/mcp-ssh/dist/server.js"],
      "env": {
        "SSH_PORT": "8889",
        "SSH_LOG_LEVEL": "info"
      }
    }
  }
}

用法

密码验证

$body = @{
    id = "test"
    host = "example.com"
    port = 22
    username = "user"
    password = "pass123"
} | ConvertTo-Json

Invoke-RestMethod -Uri "http://localhost:8889/connect" -Method Post -Body $body -ContentType "application/json"

密钥验证

$body = @{
    id = "test"
    host = "example.com"
    port = 22
    username = "user"
    privateKey = Get-Content ~/.ssh/id_rsa | Out-String
    passphrase = "optional-key-passphrase"  # 如果你的密钥受到保护
} | ConvertTo-Json

Invoke-RestMethod -Uri "http://localhost:8889/connect" -Method Post -Body $body -ContentType "application/json"

执行命令

$execBody = @{
    id = "test"
    command = "ls -la"
} | ConvertTo-Json

Invoke-RestMethod -Uri "http://localhost:8889/exec" -Method Post -Body $execBody -ContentType "application/json"

文件操作

# 上传文件
$uploadForm = @{
    file = Get-Item -Path "localfile.txt"
    remotePath = "/remote/path/file.txt"
}
Invoke-RestMethod -Uri "http://localhost:8889/upload/test" -Method Post -Form $uploadForm

# 下载文件
Invoke-RestMethod -Uri "http://localhost:8889/download/test?remotePath=/remote/path/file.txt" -Method Get -OutFile "downloaded.txt"

目录操作

# 列出目录
Invoke-RestMethod -Uri "http://localhost:8889/ls/test?path=/remote/path" -Method Get

# 获取连接状态
Invoke-RestMethod -Uri "http://localhost:8889/status/test" -Method Get

开发

1. 克隆仓库：

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

2. 安装依赖：

npm install

3. 构建：

npm run build

4. 启动服务器：

npm start

环境变量

• SSH_PORT: 服务器端口 (默认: 8889)
• SSH_LOG_LEVEL: 日志级别 (默认: info)

贡献

1. Fork 仓库
2. 创建你的特性分支 (git checkout -b feature/amazing-feature)
3. 提交你的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

MIT