AI导哈

SSH服务器实现

MCP SSH Server是一个基于SSH协议的远程命令执行和文件操作服务，支持密码和密钥认证，适用于需要安全远程管理的场景。

  • by shaike1
  • TypeScript
  • 本地部署
  • 58 星标
  • 更新于
在 GitHub 查看 shaike1/mcp-server-ssh

使用说明

MCP SSH服务器

用于模型上下文协议（MCP）的强大SSH服务器实现。此服务器通过SSH协议实现安全的远程命令执行和文件操作，支持基于密码和密钥的身份验证。

特性

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

安装

  1. 安装软件包：
npm install mcp-ssh
  1. 添加到您的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"  # if your key is protected
} | 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"

文件操作

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

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

目录操作

# List directory
Invoke-RestMethod -Uri "http://localhost:8889/ls/test?path=/remote/path" -Method Get

# Get connection status
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
  1. 安装依赖项：
npm install
  1. 构建：
npm run build
  1. 启动服务器：
npm start

环境变量

  • SSH_PORT：服务器端口（默认值：8889）
  • SSH_LOG_LEVEL：日志记录级别（默认值：info）

贡献

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

麻省理工学院

相关 MCP