classfang/ssh-mcp-server

What it solves

ssh-mcp-server 是一個橋接工具，允許 AI 助手（例如 Claude Code 或 Cursor）透過標準化介面執行遠端 SSH 指令並傳輸檔案。它解決了在不直接向模型本身暴露敏感 SSH 憑證的情況下，賦予 AI 模型操作遠端伺服器的能力問題。

How it works

該專案實作了 Model Context Protocol (MCP)，使 AI 助手能夠呼叫特定的工具，例如 execute-command、upload 和 download。伺服器在本地管理 SSH 連線，使用各種身分驗證方法（密碼、私鑰或 SSH config 檔案）並可透過 SOCKS5、HTTP 或 HTTPS 代理進行流量路由。它支援兩種傳輸模式：用於標準指令執行與 SFTP 的 exec 模式，以及用於互動式工作階段的 shell 模式，後者對於堡壘機（bastion hosts）或跳板機（jump servers）特別有用。

Who it’s for

想要將 AI agent 整合進伺服器管理工作流程，同時對 AI 可執行的內容保持安全控制的開發者、DevOps 工程師和系統管理員。

Highlights

• Credential Isolation: SSH 憑證保留在本地，絕不與 AI 模型共享。
• Command Safety: 包含靈活的白名單與黑名單機制，使用正規表示式來限制 AI 的指令範圍。
• Versatile Connectivity: 支援私鑰（含密碼保護）、SSH config 重用、透過鍵盤互動式驗證進行 2FA/MFA，以及代理支援。
• File Management: 實現本地機器與遠端伺服器之間的雙向檔案傳輸（上傳/下載）。
• Multi-Server Management: 可透過單一設定檔同時管理多個 SSH 目標。
• Command Templates: 允許將指令封裝在範本中（例如 sudo 或 `docker exec），以切換使用者或進入容器。