Ssh MCP Server

🚀 🔐 SSH-MCP-Server 中文文檔

ssh-mcp-server 是一款強大的橋樑工具，它為 AI 助手和其他支持 MCP 協議的應用程序提供了標準化接口，可遠程執行 SSH 命令。藉助該工具，AI 助手無需直接暴露 SSH 憑證，就能安全地操作遠程服務器、執行命令並獲取結果。

🚀 快速開始

ssh-mcp-server 無需全局安裝，可直接使用 NPX 快速部署運行。

✨ 主要特性

• 🔒 安全連接：支持多種安全的 SSH 連接方式，涵蓋密碼認證和私鑰認證（帶有密鑰短語支持）。
• 🛡️ 命令安全控制：通過靈活的黑名單和白名單機制，能精確控制允許執行的命令範圍，有效防止危險操作。
• 🔄 標準化接口：符合 MCP 協議規範，可與支持該協議的 AI 助手實現無縫集成。
• 📂 文件傳輸：支持雙向文件傳輸，既可以將本地文件上傳到服務器，也能從服務器下載文件。
• 🔑 憑證隔離：SSH 憑證完全在本地管理，不會暴露給 AI 模型，進一步增強了安全性。
• 🚀 即用即取：無需全局安裝，直接使用 NPX 運行即可快速部署。

📦 安裝指南

本項目無需全局安裝，直接使用 NPX 運行即可。

📦 開源倉庫

• GitHub: https://github.com/classfang/ssh-mcp-server
• NPM: https://www.npmjs.com/package/@fangjunjie/ssh-mcp-server

🛠️ 工具列表

💻 使用示例

MCP 配置示例

命令行選項

以下是可通過命令行指定的關鍵參數：

• --host 或 -h：SSH 服務端的主機地址（默認值為 localhost）
• --port 或 -p：SSH 服務端的端口號（默認值為 22）
• --user 或 -u：SSH 連接的用戶名
• --password 或 -P：SSH 連接的密碼（不推薦使用，建議優先配置密鑰認證）
• --private-key 或 -k：用於 SSH 認證的私鑰路徑
• --passphrase 或 -w：私鑰的密鑰短語
• --command-whitelist 或 -w：允許執行的命令白名單（支持正則表達式）
• --command-blacklist 或 -b：禁止執行的命令黑名單（支持正則表達式）

配置示例

使用密碼認證的配置示例

{
  "command": "npx",
  "args": [
    "--host",
    "192.168.1.100",
    "--port",
    "22",
    "--user",
    "root",
    "--password",
    "your_password_here"
  ]
}

使用私鑰認證的配置示例

{
  "command": "npx",
  "args": [
    "--host",
    "192.168.1.100",
    "--port",
    "22",
    "--user",
    "root",
    "--private-key",
    "/path/to/private_key.pem",
    "--passphrase",
    "your_passphrase_here"
  ]
}

使用命令白名單的配置示例

{
  "command": "npx",
  "args": [
    "--host",
    "192.168.1.100",
    "--port",
    "22",
    "--user",
    "root",
    "--password",
    "your_password_here",
    "--command-whitelist",
    "^ls$|^pwd$"
  ]
}

使用命令黑名單的配置示例

{
  "command": "npx",
  "args": [
    "--host",
    "192.168.1.100",
    "--port",
    "22",
    "--user",
    "root",
    "--password",
    "your_password_here",
    "--command-blacklist",
    "^rm .*"
  ]
}

⚠️ 重要提示

如果同時指定白名單和黑名單，系統將首先檢查命令是否在白名單中，然後檢查是否在黑名單中。只有通過兩者的檢查，命令才會被執行。