MCP SSH/SFTP 服务器

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. 所有密码信息请妥善保管，避免泄露