MCP SSH Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Supports Git operations through the underlying SSH protocol, allowing for secure repository access and management via standard SSH authentication.

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 :日志级别(默认值:信息)

贡献

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

执照

麻省理工学院

-
security - not tested
F
license - not found
-
quality - not tested

模型上下文协议的安全 SSH 服务器实现,支持远程命令执行和文件操作,支持密码和基于密钥的身份验证。

  1. Features
    1. Installation
      1. Usage
        1. Password Authentication
        2. Key Authentication
        3. Execute Commands
        4. File Operations
        5. Directory Operations
      2. Development
        1. Environment Variables
          1. Contributing
            1. License
              ID: evsuu87spp