MCP

用 hop mcp 先列出 SSH 連線

適合要讓助手管理伺服器連線的人;請先 brew 安裝再用 hop mcp 登記,切勿在非互動工作階段執行裸 hop,第一次請先呼叫 list_connections。

官方來源 · hop

安裝

brew install danmartuszewski/tap/hop

適合誰

適合要讓 AI 助手管理伺服器連線的人:search connections、run commands、check status across projects。hop 同時是 SSH 連線管理器,但 MCP 路徑用的是 hop mcp,不是互動式面板。

它不是雲端跳板機。連線設定在本機。官方寫明 Config file location: ~/.config/hop/config.yaml。不要改 ~/.ssh/config:hop 只透過 hop import 讀取它。

官方頁面:

https://github.com/danmartuszewski/hop

3 分鐘完成第一次嘗試

先裝官方二進位:

brew install danmartuszewski/tap/hop

再登記 MCP。Claude Code:claude mcp add hop -- hop mcp。Codex CLI:codex mcp add hop -- hop mcp。Claude Desktop / Cursor / Windsurf 則寫入 { "hop": { "command": "hop", "args": ["mcp"] } }。不要另找未出現的安裝器。

前置條件:本機能跑 brew;不要在非互動工作階段裡執行裸 hop。官方警告:bare hop 會啟動 interactive TUI and will hang。請用子命令,例如 hop version、hop list。

設定位置:上述用戶端的 MCP 設定,以及 ~/.config/hop/config.yaml。官方沒有寫 YAML 欄位表。

第一次呼叫必須用已點名的工具 list_connections。成功訊號:助手能列到連線(可以為空),且沒有對遠端執行命令。空列表只說明還沒有匯入連線,不代表 hop mcp 沒掛上。

不要把列連線理解成零風險:它會讀本機 hop 設定;後續若 run commands,會真正打到伺服器。先確認 list_connections 通了再談執行。

使用案例

案例一:確認 MCP 工具可達。呼叫 list_connections。官方把它當作「Confirm hop's MCP tools are reachable」的例子。沒有給出過濾或專案欄位。

案例二:在已能列出連線之後,再按官方能力去 search connections 或 check status across projects。連續說明沒有給出這兩個動作的工具函式名,不要編造。需要執行命令時,那是寫操作:先確認目標連線,並記住這不是本機模擬。匯入已有 SSH 設定只用 hop import,不要手改 ~/.ssh/config。

使用邊界

行程邊界:非互動環境禁止裸 hop,以免 TUI 掛死。設定邊界:主檔是 ~/.config/hop/config.yaml;~/.ssh/config 只讀匯入。

能力邊界:已點名 MCP 工具是 list_connections。search / run commands / check status 只作為能力被提到。官方沒有寫金鑰代理、跳板欄位或遠端安裝方式。