Hermes Agent MCP Mac 設定：擴充本機開發工具鏈（2026）

Hermes Agent（Nous Research，GitHub，MIT）可透過 MCP（Model Context Protocol） 連接外部工具伺服器，將本機開發工具鏈（檔案系統、GitHub、Codex CLI）接入代理迴圈，密鑰放在 ~/.hermes/.env。

為何在 Mac 上用 MCP 擴充 Hermes

開發者常需要：限定目錄的檔案存取、Issue/PR 整合，以及讓 IDE 共用 Hermes 訊息通道。

Hermes 作為 MCP 用戶端 讀取 mcp_servers；作為 伺服器 時執行 hermes mcp serve 供 Cursor / Claude Code 使用。

可引用定義：工具名為 mcp_<server>_<tool>，支援 stdio 與 HTTP OAuth。

請先完成 Hermes Agent Mac 安裝指南。

架構：設定、傳輸與工具名

參考 官方 MCP 文件 與 OpenClaw MCP 環境變數。

macOS 上七步設定 MCP

步驟 1 — 確認 MCP 依賴

標準 install.sh 已包含 MCP。若 hermes doctor 報警：

cd ~/.hermes/hermes-agent && uv pip install -e ".[mcp]"

確認 node --version 與 npx --version 可用。

步驟 2 — 綁定單一倉庫根目錄

編輯 ~/.hermes/config.yaml，在 mcp_servers.project_fs 中設定：

npx -y @modelcontextprotocol/server-filesystem /Users/you/dev/my-app（替換為真實路徑，勿掛載整個使用者目錄）。

步驟 3 — 從 catalog 安裝 GitHub

執行 hermes mcp 或 hermes mcp install github，依提示寫入 token，並在安裝清單中關閉破壞性工具。

步驟 4 — 可選 Codex 預設

hermes mcp add codex --preset codex（需本機 codex 在 PATH 中）。

步驟 5 — 工具白名單

為 GitHub 等伺服器設定 tools.include 與 tools.prompts: false，僅註冊需要的 mcp_github_* 工具。

步驟 6 — TUI 驗證

執行 hermes，要求列出專案根目錄檔案。修改 YAML 後執行 /reload-mcp。OAuth 請在新終端執行 hermes mcp login <server>。

步驟 7 — 供 Cursor 呼叫 Hermes

在 Cursor MCP 設定中加入 hermes + mcp serve。讀取無需 gateway；傳送需 hermes gateway，見 安裝指南。

開發情境（stdio vs HTTP）

筆電先 filesystem + 一個 catalog；穩定後再加 HTTP OAuth。24/7 Mac mini 請控制並行 stdio 程序數。

疑難排解

無法連線 MCP 伺服器

現象：連線錯誤，TUI 中無 mcp_* 工具。

修復：uv pip install -e ".[mcp]" 後執行 hermes doctor，檢查 mcp_servers: YAML。

安裝成功但無工具

現象：catalog 完成但代理從不呼叫 MCP。

原因：tools.include 過窄或 OAuth 未完成。執行 hermes mcp configure github。

SSH 遠端 OAuth

現象：筆電瀏覽器，無頭 Mac 上的 Hermes。

修復：貼上重定向 URL 或 ssh -L；在 SSH 工作階段執行 hermes mcp login。

FAQ

延伸閱讀

• 8B 本地模型調參：止住 Agent 死循環
• Hermes 軌跡壓縮：AI 帳單 $500→$50
• Hermes Agent 定時任務：Discord 自動日報
• Hermes Agent Mac 安裝指南
• OpenClaw MCP 環境變數與 launchd