MCP（7 筆）

MCP server 連接與工具載入相關的官方 issue。資料來自官方 GitHub repo，狀態由官方 label 推導，每筆附原始連結與最後檢查日期。

#58345 有暫時解法 P2 comp/agent

[Bug] xAI grok-4.3 在 MCP 工具呼叫中丟失選填多行字串參數，AgentMail 寄出空白信

回報者發現在 provider xai-oauth 配 grok-4.3（codex_responses 模式）時，AgentMail 的 send_message 每次都寄出主旨與內文都空白的信，但工具回報成功，agent 無法自我修正。此 issue 由 AI agent 調查並代表帳號擁有者提交，附可重現的證據。

#58325 討論中 P3 comp/agent

[提案] 把 Hermes 當作 Gotong 治理工作流中的個人 agent 層

Gotong 專案作者提出整合構想：Hermes 繼續當個人 agent / 記憶 / 推理層，Gotong 提供外圍的治理協作基底（任務派發、人工審批、append-only 紀錄、MCP/A2A 邊界）。屬於外部專案的整合提案。

#57836 已修復 P2 comp/gateway

[Bug] 無互動模式下 MCP OAuth 因快取過期的 token 卡住 gateway 啟動

回報者指出在非互動式的 hermes gateway run 情境下，即使已有 OAuth token 檔案，只要 refresh 或授權失敗就會落入需要瀏覽器回呼的流程，導致 gateway 在訊息平台啟動前卡住整個 callback timeout，且重試會因為連接埠被佔用而失敗。此 issue 已關閉。

#57228 有暫時解法 P2 comp/agent

MCP stdio 子程序在長時間運作的 worker 中重新連線時會洩漏，孤兒程序持續累積直到 DB 爭用

長時間執行的 Hermes worker 會累積孤兒 MCP stdio 子程序，案例中單一 worker process 累積了 53 個 mimir 子程序，共佔用 1.4GB RSS 與大量檔案描述符，全部搶同一個 SQLite DB，超過約 50 個子程序後會造成 DB handle 爭用，導致 memory 工具呼叫間歇性失敗，但 hermes mcp test mimir 仍顯示健康。

#38448 有暫時解法 P2 comp/cli

hermes -z（oneshot 模式）可能漏掉 MCP 工具，因為工具清單在 MCP 探索完成前就先被快照

在 hermes -z（oneshot 模式）下，即使 MCP server 通過 hermes mcp test 測試且能探索到工具，agent 實際可用的工具清單中卻沒有這些 MCP 工具。原因是 oneshot.py 在建立 AIAgent 時就已解析好工具清單，時間點在 MCP discovery 註冊動態工具之前，導致之後才加入的工具永遠不會被看到。

暫時解法

在 oneshot.py 解析平台工具集前先手動呼叫 discover_mcp_tools()，可讓 MCP 工具正常被找到，回報者確認本機測試有效。

學校診斷與解法

#34871 有暫時解法 P2 tool/mcp

執行 hermes mcp serve 出現 ModuleNotFoundError 找不到 mcp_serve 模組

標準 pip 安裝後啟動 MCP server 會因為模組路徑問題崩潰。官方標為 P2,代表有暫時解法可繞過。

暫時解法

確認以完整套件方式安裝,必要時重裝並清掉殘留快取再重啟。改完設定後記得重置 session 讓 MCP 重新載入。

學校診斷與解法

#29299 討論中 P3 tool/mcp

功能請求：MCP OAuth 需要支援 HTTPS callback URL（而非只能用本機 HTTP）

目前 Hermes 的 MCP OAuth 只支援 http://127.0.0.1:8765/callback 這種本機 HTTP callback，許多 OAuth 服務（如 Salesforce 官方 MCP 流程）不接受這種格式。issue 提議在 config 增加 redirect_uri 覆寫選項以支援 HTTPS。

學校診斷與解法

其他分類

回官方 Issue 精選問答．看學校解法卡．常見問題排解