工具推薦｜mcp-spend-guard — 幫每個 MCP server 加一個花費上限與斷路器

🌏 English version

工具資訊

解決什麼問題

你是否接過一個 MCP server，然後放心讓 agent 自己決定要呼叫幾次？MCP 協定本身沒有內建任何限流機制——一個卡在迴圈裡的 agent 可以對同一個付費 tool（搜尋 API、圖片生成、企業級 SaaS 呼叫）連打幾百次，直到你自己發現帳單或 log 才驚覺;更麻煩的是,如果 fetch 回來的網頁內容裡藏了 prompt injection，誘導模型對一份 CSV 的每一列都呼叫一次昂貴的 enrichment tool，這種攻擊面完全不需要 agent 本身「壞掉」，client 端也沒有任何機制能攔下來。

mcp-spend-guard 是一個插在 MCP client 和真正的 MCP server 之間的 stdio JSON-RPC relay：它把子行程開起來，逐行轉發 JSON-RPC frame，唯一會攔下的請求是撞到上限的 tools/call。上限寫在一份 YAML 裡——總呼叫數、每分鐘呼叫數、估算花費上限（每個 tool 自己填一個單價）、wall-clock timeout，外加一個「N 次連續錯誤就跳斷路器」的機制。所有計數存在本機 SQLite,重開機或 client 斷線重連都不會歸零。想緊急煞車時,在另一個 terminal touch STOP 就好,不用改設定、不用重啟。

適合場景：你的 agent 串了任何按次計費或有明確成本的 MCP tool（搜尋、圖片生成、第三方付費 API），想要一個不依賴 agent 自律、也不用自己在應用層寫節流邏輯的硬煞車;或是純粹想知道「這個 session 到底打了幾次、花了多少」，跑一次 mcp-spend-guard report 就有答案。

快速上手

安裝

pipx install .        # 或：pip install .

基本用法

# guard.yaml
server:
  command: npx
  args: ["-y", "@acme/search-mcp"]

limits:
  max_calls_total: 200
  max_calls_per_minute: 30
  max_spend_usd: 5.00

costs:
  tools:
    web_search: 0.01

safety:
  kill_switch_file: ./STOP
  circuit_breaker_errors: 5

 {
   "mcpServers": {
     "search": {
-      "command": "npx",
-      "args": ["-y", "@acme/search-mcp"]
+      "command": "mcp-spend-guard",
+      "args": ["run", "-c", "/abs/path/to/guard.yaml"]
     }
   }
 }

# 看這個 session 花了多少、被擋了幾次
mcp-spend-guard report

進階用法

# 從另一個 terminal 立刻凍結所有呼叫
touch STOP
# 恢復正常
rm STOP

上限第一個被撞到的會直接回傳一個乾淨的 JSON-RPC 錯誤，agent 看到的不是卡死，是明確的拒絕原因：

{"jsonrpc":"2.0","id":3,"error":{"code":-32011,
 "message":"mcp-spend-guard blocked this call [max_spend_usd]: spend cap reached: $0.2000 estimated spend, this call adds $0.1000, limit $0.2500",
 "data":{"cap":"max_spend_usd","limit":0.25,"current":0.2,"tool":"web_search","guard":"mcp-spend-guard"}}}

與現有工具的比較

注意事項

• 花費是估算,不是實際帳單：單價由你自己填在 costs.tools 裡，guard 完全看不到任何 provider 的真實發票——估錯了上限就跟著錯，該當斷路器用，不能拿來對帳。
• 目前只支援 stdio：HTTP／SSE transport 的 MCP server 還沒被包住，README 自己列在待辦清單裡。
• 計費粒度是每次呼叫,不是每個 token：輸入大小會影響實際成本的 tool，沒辦法精準建模；而且一台機器包五個 server 就要五份設定，除非刻意共用同一個 db_path 和 session_id，否則預算不會互通。剛發佈不到一天,只有單一貢獻者、1 顆星,schema 之後可能還會調整。

今日收穫

MCP 生態這一年一直在補「這個 agent 能連上哪些 server、能叫哪些 tool」的准駁層（像上週介紹過的 mcp-guardrail），但「叫了之後到底花了多少、會不會停不下來」是另一個完全獨立的維度——准駁答不出「值不值得」，只有計量機制答得出來。兩者疊在一起，才算是把「agent 自己決定要不要用某個 tool」這件事真正收攏成人可以掌握的邊界。

參考資料

• mcp-spend-guard GitHub repo：專案介紹、README、安裝指令、config schema、運作架構、授權（MIT）均出自官方 README。
• Model Context Protocol 官方文件：MCP 協定介紹。