Ssh Hub

🚀 ssh-hub

ssh-hub 是一個 MCP 服務器，它允許 AI 編碼代理通過 SSH 完全訪問遠程機器。你可以同時連接到多個服務器，並通過 MCP 工具界面進行遠程文件操作、執行 shell 命令以及目錄同步。

🚀 快速開始

# 1. 添加遠程服務器
ssh-hub add <SERVER_ALIAS> user@host

# 2. 在項目中註冊為 MCP
ssh-hub mcp-install /path/to/project

連接字符串格式

user@host                  # 默認端口 22，路徑為 ~
user@host:/path            # 顯式指定路徑
user@host:2222             # 自定義端口，路徑為 ~
user@host:2222:/path       # 自定義端口和路徑

身份文件

對於受密碼短語保護的密鑰，在 add 命令中使用 -i 參數 —— ssh-hub 會將密鑰加載到你的 SSH 代理中：

注意：如果訪問私鑰需要密碼短語，此命令將通過 ssh-add 詢問密碼短語並安全存儲。

ssh-hub add <SERVER_ALIAS> user@host -i ~/.ssh/my_key

📦 安裝指南

cargo install --git https://github.com/Perceptron-Studios/ssh-hub.git

升級

ssh-hub upgrade

💻 使用示例

基礎用法

# 啟動 MCP 服務器
ssh-hub

# 列出已配置的服務器
ssh-hub list

# 添加服務器
ssh-hub add <name> <connection>

# 從配置中移除服務器
ssh-hub remove <name>

# 更新服務器元數據和連接設置
ssh-hub update <name>

# 在項目中註冊 ssh-hub 為 MCP 服務器
ssh-hub mcp-install [directory]

# 升級到最新版本
ssh-hub upgrade

高級用法

# 詳細日誌記錄
ssh-hub -v

# 指定身份文件
ssh-hub add <name> <connection> -i <path>

# 覆蓋端口
ssh-hub add <name> <connection> -p <port>

# mcp-install 僅生成 .mcp.json
ssh-hub mcp-install [directory] --claude

# mcp-install 僅生成 .codex/config.toml
ssh-hub mcp-install [directory] --codex

📚 詳細文檔

CLI 命令

選項： -v 詳細日誌記錄，-i <path> 身份文件，-p <port> 端口覆蓋。

mcp-install 標誌： --claude（僅生成 .mcp.json），--codex（僅生成 .codex/config.toml）。默認兩者都生成。

🔧 技術細節

身份驗證

所有身份驗證均基於 SSH 密鑰。不存儲或傳輸密碼。密鑰按以下順序嘗試：

1. 身份文件 —— 在 add 命令中使用 -i 指定的密鑰（優先級最高）
2. SSH 代理 —— 通過 ssh-add 加載的密鑰，簽名委託給 ssh-agent（最多 10 個密鑰）
3. 默認密鑰 —— ~/.ssh/id_ed25519、id_rsa、id_ecdsa

RSA 密鑰會自動與 SHA-256/SHA-512 簽名進行協商（現代服務器拒絕舊的 SHA-1）。

MCP 工具

所有工具在首次使用時會自動連接到已配置的服務器，無需手動連接步驟。每個工具都接受一個 server 參數，引用已配置的服務器名稱。

發現

• list_servers —— 顯示已配置的服務器，並進行即時可達性探測（TCP ping 並顯示延遲）

遠程操作

• remote_bash —— 執行 shell 命令（可選超時和後臺模式）
• remote_read —— 讀取文件內容（大文件可指定偏移量和限制）
• remote_write —— 將內容寫入文件
• remote_edit —— 使用字符串替換編輯文件
• remote_glob —— 查找匹配 glob 模式的文件

同步

• sync_push —— 將本地文件或目錄推送到遠程（目錄使用 tar 流傳輸）
• sync_pull —— 將遠程文件或目錄拉取到本地（目錄使用 tar 流傳輸）

配置

服務器配置存儲在 ~/.config/ssh-hub/servers.toml（macOS：~/Library/Application Support/ssh-hub/servers.toml）：

[servers.staging]
host = "staging.example.com"
user = "deploy"
port = 2222
remote_path = "/var/www/app"
identity = "~/.ssh/id_staging"

[servers.prod]
host = "prod.example.com"
user = "deploy"
remote_path = "~"

📄 許可證

MIT