mcp-ssh-toolkit-py

基本能力

产品定位

mcp-ssh-toolkit-py 是一个专为 SSH 自动化设计的 MCP 服务器，旨在通过 MCP 协议提供安全的远程服务器管理能力。

核心功能

• SSH 命令执行：在远程服务器上执行任意命令。
• SFTP 操作：支持文件的上传和下载。
• 多种认证方式：包括用户名/密码、SSH 密钥和 SSH 代理。
• 集成能力：与 Claude/Cline 等 MCP 客户端兼容，支持 Docker 和 Pip 安装。
• 安全性：提供加密连接、可配置超时和无凭证存储的安全特性。

适用场景

• DevOps 自动化：通过 LLMs 实现自动化操作。
• 服务器管理：通过聊天界面管理服务器。
• 远程脚本执行：安全地执行远程脚本。
• MCP 生态系统集成：在 MCP 生态中集成 SSH 功能。

工具列表

• ssh_execute_command：执行远程命令，支持多种参数配置，如主机地址、用户名、密码、命令等。

常见问题解答

• 安全性：SSH 凭证不会被存储或记录，建议使用强密码或 SSH 密钥。
• 网络暴露：不建议将 MCP 服务器暴露给不受信任的网络。
• 漏洞报告：发现安全漏洞可通过 GitHub Issues 或直接联系维护者报告。

使用教程

使用依赖

• Python 3.8+
• python-sdk
• paramiko

安装教程

Docker 安装（推荐）

1. 克隆仓库：

git clone https://github.com/VitalyMalakanov/mcp-ssh-toolkit-py.git
cd mcp-ssh-toolkit-py

1. 构建 Docker 镜像：

docker build -t mcp-ssh-toolkit-py .

1. （可选）推送到 Docker 注册表：

docker tag mcp-ssh-toolkit-py yourusername/mcp-ssh-toolkit-py
docker push yourusername/mcp-ssh-toolkit-py

Pip 安装

从 GitHub 直接安装：

pip install git+https://github.com/VitalyMalakanov/mcp-ssh-toolkit-py.git

安装后运行服务器：

python -m mcp_ssh_toolkit

开发设置

开发环境下安装：

git clone https://github.com/VitalyMalakanov/mcp-ssh-toolkit-py.git
cd mcp-ssh-toolkit-py
pip install -e .

调试方式

使用 Docker 运行

docker run --rm -i mcp-ssh-toolkit-py

MCP 集成

添加到 MCP 配置（如 cline_mcp_settings.json）：

"mcp-ssh-toolkit-py": {
  "command": "docker",
  "args": ["run", "--rm", "-i", "mcp-ssh-toolkit-py"],
  "env": {}
}

本地运行

python main.py

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。