mcp-ssh-toolkit-py

🚀 mcp-ssh-toolkit-py

mcp-ssh-toolkit-py 是一个基于 python-sdk 和 paramiko 的轻量级模型上下文协议（MCP）服务器，用于通过 SSH 进行安全自动化。它能安全地执行远程 SSH 命令，适用于 DevOps 自动化、服务器管理等场景。

🚀 快速开始

依赖安装

pip install -r requirements.txt

快速运行

python main.py

✨ 主要特性

核心功能

• 🛡️ 通过 MCP 安全地执行 SSH 命令
• 📁 支持文件的上传和下载操作
• 🔐 支持多种身份验证方式（密码、SSH 密钥）
• ⚙️ 可配置的连接参数（超时、端口等）

技术特性

• 使用 paramiko 实现 SSH 协议
• 集成 python-sdk 提供 MCP 支持
• 支持异步操作，提升性能

主要功能及用例

• 主要功能：
  • 通过 SSH 在远程服务器上执行任意命令
  • 上传/下载文件 (SFTP)
  • 集成与 Claude/Cline 和其他 MCP 客户端
  • 支持密码和 SSH 密钥身份验证
  • 可配置的连接参数（超时、端口）
• 用例：
  • 通过 LLM 进行 DevOps 自动化
  • 服务器管理聊天界面
  • 安全远程脚本执行
  • SSH 在 MCP 生态中的集成

💻 使用示例

基础用法

# 通过 MCP 客户端
response = mcp.tool("ssh_execute_command", {
    "host": "example.com",
    "username": "user",
    "command": "docker ps"
})

简单示例

以下是一个通过 MCP 工具快速执行远程命令的示例：

{
  "host": "example.com",
  "username": "user",
  "password": "secret",
  "command": "uname -a"
}

返回结果

• stdout: 命令输出
• stderr: 错误输出
• exit_code: 退出码

📚 详细文档

开发

• 环境要求：Python 3.8+
• 依赖管理：

  pip install -r requirements.txt
  

主要模块

1. main.py：主程序入口，启动 MCP 服务
2. ssh_handler.py：处理 SSH 连接和命令执行
3. file_handler.py：处理文件上传和下载操作

安全注意事项

• 不要将 SSH 凭证存储在代码中或明文日志中。
• 始终使用强密码或 SSH 密钥进行身份验证。
• 避免将 MCP 服务器暴露到不信任的网络环境中。
• 查阅 paramiko 安全最佳实践。
• 如果发现安全漏洞，请通过 GitHub Issues 或私下联系维护者报告。

📄 许可证

本项目采用 MIT License。更多细节请参见 LICENSE 文件。