AI导哈

SSH/SFTP服务器

一个基于Model Context Protocol (MCP)实现的SSH和SFTP服务器集合，提供远程服务器操作和文件传输功能。

  • by naya-cat-1
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 naya-cat-1/mcp-ssh-sftp-server

使用说明

MCP SSH/SFTP 服务器

English | 简体中文

这是一个基于 Model Context Protocol (MCP) 实现的 SSH 和 SFTP 服务器集合，提供了远程服务器操作和文件传输的功能。

项目结构

.
├── ssh-server/    # SSH服务器实现
└── sftp-server/   # SFTP服务器实现

功能特性

SSH 服务器

SSH服务器提供远程命令执行功能，支持：

  • 连接到远程SSH服务器
  • 执行远程命令并获取结果
  • 自动断开连接和资源清理

SFTP 服务器

SFTP服务器提供文件传输相关功能，支持：

  • 列出远程目录内容
  • 上传本地文件到远程服务器
  • 从远程服务器下载文件
  • 自动重试连接机制
  • 详细的调试日志

可用工具

SSH 工具

execute_ssh_command

执行远程SSH命令

  • 参数：
    • host: SSH服务器地址
    • port: SSH端口
    • username: 用户名
    • password: 密码
    • command: 要执行的命令

SFTP 工具

list_directory

列出远程目录内容

  • 参数：
    • host: SFTP服务器地址
    • port: SFTP端口
    • username: 用户名
    • password: 密码
    • remotePath: 要列出内容的远程目录路径

upload_file

上传文件到远程服务器

  • 参数：
    • host: SFTP服务器地址
    • port: SFTP端口
    • username: 用户名
    • password: 密码
    • localPath: 本地文件路径
    • remotePath: 远程目标路径

download_file

从远程服务器下载文件

  • 参数：
    • host: SFTP服务器地址
    • port: SFTP端口
    • username: 用户名
    • password: 密码
    • remotePath: 远程文件路径
    • localPath: 本地保存路径

错误处理

两个服务器都实现了完善的错误处理机制：

  • 连接超时处理
  • 自动重试机制（SFTP服务器）
  • 详细的错误信息输出
  • 资源自动清理

配置说明

  1. 复制 servers.json.example 为 servers.json
  2. 在 servers.json 中配置你的服务器信息
  3. servers.json 已被 .gitignore 忽略，不会被提交到版本控制

配置示例：

{
  "my-server": {
    "host": "example.com",
    "port": 22,
    "username": "your-username",
    "password": "your-password",
    "description": "我的服务器"
  }
}

安全说明

  • servers.json 包含敏感信息，切勿提交到版本控制
  • 所有密码信息都只在内存中临时使用，不会被持久化存储
  • 每次操作后都会自动断开连接
  • 支持连接超时机制，避免资源占用
  • 建议使用私钥认证代替密码认证

调试功能

SFTP服务器提供了详细的调试日志输出，包括：

  • 连接状态日志
  • 操作执行过程日志
  • 错误详情日志

注意事项

  1. 使用前请确保有正确的服务器访问权限
  2. 建议在使用前测试连接参数
  3. 对于大文件传输，请注意网络状况和超时设置
  4. 所有密码信息请妥善保管，避免泄露

相关 MCP