🚀 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
主要模块
- main.py：主程序入口，启动 MCP 服务
- ssh_handler.py：处理 SSH 连接和命令执行
- file_handler.py：处理文件上传和下载操作
安全注意事项
- 不要将 SSH 凭证存储在代码中或明文日志中。
- 始终使用强密码或 SSH 密钥进行身份验证。
- 避免将 MCP 服务器暴露到不信任的网络环境中。
- 查阅 paramiko 安全最佳实践。
- 如果发现安全漏洞，请通过 GitHub Issues 或私下联系维护者报告。
📄 许可证
本项目采用 MIT License。更多细节请参见 LICENSE 文件。