想讓 Agent 調用工具不翻車？別再靠猜了

mcphello.com 上線了「全球最大中文 MCP 工具目錄」。它不是 Demo 庫，也不是文檔示例——而是直接公開真實生產環境中的 MCP 調用日志：

• tool_use 請求體（比如 Claude 4 發出的）：

  {
  "type": "tool_use",
  "id": "t_123",
  "name": "web_search",
  "input": {
    "query": "2024Q2深圳跨境電商GMV"
  }
  }

• 對應的 tool_result 響應頭、錯誤重試邏輯，甚至 status: "partial_failure" 后自動降級到本地緩存的完整鏈路。

所有數據來自真實用戶會話，不是偽代碼，也不是理想化流程。

跨模型兼容性不是紙上談兵

目錄內置兼容性矩陣，覆蓋 8 個主流 Agent Runtime：OpenClaw Server、Lobster CLI、LangChain MCP Adapter、Ollama MCP Gateway 等。

每項工具都標注了實際運行差異：

• 字段要求：ChatGPT 強制 tool_id；Claude 接受 tool_use_id；
• 超時閾值：Cursor 默認 3s；Claude 設為 6s；
• 安全限制：某些 Runtime 禁止 file_write 寫入 /tmp 以外路徑。

這些結論來自 172 個真實調用 Case 的驗證，不是理論推測。

怎么用？

• 做 A2A 通信：直接復用 web_search 的 MCP Schema 定義，5 分鐘接入自有 API；
• 開發 Server 插件：查矩陣，選支持 streaming: true 的 Runtime，避免 Agent 卡死；
• 設計商業化流程：參考日志里“小紅書爆款分析 → 自動生成圖文 → 批量發布”的鏈路，快速落地可收費的 SaaS 自動化模塊（某客戶已用該路徑月均增收 ￥23,800）。

別從零啃 RFC。去 mcphello.com，搜 financial_report_generator，下載帶簽名驗證的 MCP Schema 文件，今天就跑通第一條生產級工具調用。