MCP Ssh Toolkit Py

mcp-ssh工具包py

  ](https://hub.docker.com/r/vitalymalakanov/mcp-ssh-toolkit-py) 

______________________________________________________________________

目录

• 概述
• 特性
• 安装
• 快速启动
• 用法
• 发展
• 许可证

______________________________________________________________________

概述🚀

mcp-ssh工具包py 是一个功能强大的MCP服务器，用于通过模型上下文协议安全执行SSH命令。

🔹 主要特点:

• 通过SSH在远程服务器上执行任意命令
• 通过SFTP上传/下载文件
• 与Claude/Cline和其他MCP客户集成
• 支持密码和SSH密钥身份验证
• 可配置的连接参数（超时、端口）

🔹 用例:

• 通过LLM实现DevOps自动化
• 通过聊天界面进行服务器管理
• 安全远程脚本执行
• MCP生态系统中的SSH集成

示例用法：

# Through MCP client
response = mcp.tool("ssh_execute_command", {
    "host": "example.com",
    "username": "user",
    "command": "docker ps"
})

______________________________________________________________________

特性✨

核心功能

• 🛡️ 通过MCP安全执行SSH命令
• 📁 SFTP操作（文件上传/下载）
• 🔑 多种身份验证方法：

- 用户名/密码 - SSH密钥（RSA） - SSH代理

整合

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

安全

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

______________________________________________________________________

安装📦

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

管道安装

直接从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 （string，必填）：要执行的命令
• port （整数，可选，默认22）：SSH端口
• timeout （整数，可选，默认值20）：连接超时（秒）

输出：

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

示例调用：

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

______________________________________________________________________

发展

• Python 3.8+
• python sdk
• 帕拉米科

在本地安装依赖项：

pip install -r requirements.txt

在本地运行：

python main.py

______________________________________________________________________

安全

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

______________________________________________________________________

许可证

MIT许可证。看 许可证 了解详情。