mcp-ssh-toolkit-py

一个最小化的模型上下文协议 (MCP) 服务器，用于安全的 SSH 自动化，使用 python-sdk 和 paramiko 构建。

---

目录

• 概述
• 特性
• 安装
• 快速开始
• 使用
• 开发
• 许可

---

概述 🚀

mcp-ssh-toolkit-py 是一个强大的 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 命令
• 📁 SFTP 操作（文件上传/下载）
• 🔑 多种身份验证方法：
  • 用户名/密码
  • SSH 密钥 (RSA)
  • SSH agent

集成

• 🤖 完全兼容 Claude/Cline
• 🐳 即用型 Docker 镜像
• 📦 Pip 包安装

安全

• 🔒 加密连接
• ⏱ 可配置的超时
• 🚫 不存储凭据

---

安装 📦

Docker (推荐)

1. 克隆仓库:

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

2. 构建 Docker 镜像:

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

3. (可选) 推送到您的 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": {}
}

---

使用

工具: ssh_execute_command

描述: 通过 SSH 在远程服务器上执行命令。

输入参数:

• host (字符串, 必需): SSH 服务器地址
• username (字符串, 必需): SSH 用户名
• password (字符串, 可选): SSH 密码
• privateKey (字符串, 可选): SSH 私钥路径 (PEM)
• command (字符串, 必需): 要执行的命令
• port (整数, 可选, 默认 22): SSH 端口
• timeout (整数, 可选, 默认 20): 连接超时 (秒)

输出:

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

调用示例:

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

---

开发

• Python 3.8+
• python-sdk
• paramiko

在本地安装依赖项:

pip install -r requirements.txt

在本地运行:

python main.py

---

安全

• SSH 凭据永远不会被存储或记录。
• 始终使用强密码或 SSH 密钥进行身份验证。
• 不要将 MCP 服务器暴露给不受信任的网络。
• 查看 paramiko 安全最佳实践。
• 如果您发现安全漏洞，请通过 GitHub Issues 报告或私下联系维护者。

---

许可

MIT 许可证。 有关详细信息，请参见 LICENSE。