mcp-ssh-toolkit-py

一个基于 python-sdk 和 paramiko 的轻量级模型上下文协议（MCP）服务器，用于通过 SSH 进行安全自动化。

目录

• 概述
• 功能
• 安装
• 快速入门
• 使用方法
• 开发
• 许可证

概述 🚀

mcp-ssh-toolkit-py 是一个强大的 MCP 服务器，用于通过模型上下文协议（MCP）安全地执行远程 SSH 命令。

🔹 主要功能：

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

技术特性

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

安装

依赖安装

pip install -r requirements.txt

快速运行

python main.py

使用方法

简单示例

以下是一个通过 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 文件。