MCP Ssh Toolkit Py

🚀 mcp-ssh-toolkit-py

mcp-ssh-toolkit-py 是一個基於 python-sdk 和 paramiko 的輕量級模型上下文協議（MCP）服務器，可通過 SSH 實現安全自動化，能在遠程服務器執行命令、上傳下載文件等。

🚀 快速開始

mcp-ssh-toolkit-py 是強大的 MCP 服務器，可通過模型上下文協議（MCP）安全執行遠程 SSH 命令。以下是簡單使用示例：

# 通過 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 文件。