如果您的 Claude Code、OpenAI Codex CLI、Cursor 或 VS Code Copilot 使用 Model Context Protocol (MCP) 伺服器,您的上下文視窗和提示詞快取可能會遇到三種靜默故障模式。
首先是「啟動 Schema 膨脹 (tools/list)」,連接三個常見的 MCP 伺服器(GitHub、Postgres、Playwright)會將超過 60 個工具的 JSON Schema(約 20,000 個以上的 token)注入到每個回合中。
其次是「過大的標準輸入輸出框架拆解 (tools/call)」,在 Claude Code 中返回超過 8 MiB 的資料會導致標準輸入輸出伺服器程序因「<error>Connection closed</error>」而崩潰;在 Codex CLI 中返回超過 16 MiB 的資料則會靜默地丟棄該框架,直到 300 秒的工具逾時結束。
最後是「靜默的提示詞快取失效與配置漂移」,MCP 工具的重新排序、cache_control 前的動態前綴,或會話中途的 "disableAllHooks": true 編輯,都會靜默地消耗 token 或移除安全防護。
為了解決這些問題,我們開發了三款零遙測的開源工具,用於檢查並預防這三種故障模式。它們分別是 @framy2/ctxwise (v1.2.0),一個上下文防火牆、多編輯器 MCP 稽核器和 CI 預算守護者;@framy2/mcp-diet (v0.1.1),一個帶有 tools/list Tree-Shaking、8 MiB 溢出到磁碟崩潰防護和秘密遮蔽功能的標準輸入輸出 MCP 代理;以及 @framy2/agent-wire-tap (v0.2.0),一個本地線路合約測試器和即時 --passthrough 提示詞前綴快取遺失偵錯器。
1. 讓您的 MCP 伺服器「瘦身」(@framy2/mcp-diet)
mcp-diet 位於主機 CLI 和上游 MCP 伺服器之間的標準輸入輸出通道上。它會將超過 512 KiB 的工具輸出溢出到本地暫存檔案,並返回一個精簡的、小於 2 KB 的預覽,確保 Claude Code (8 MiB) 和 Codex (16 MiB) 永遠不會中斷管道。
此外,它還會確定性地排序工具 Schema,以保持提示詞前綴快取處於「溫熱」狀態。它也能在敏感資料到達模型轉錄之前,遮蔽洩漏的憑證(例如 sk-ant-、sk-proj-、ghp_、AKIA、資料庫密碼)。
2. 稽核每個編輯器並鎖定 CI 預算 (@framy2/ctxwise v1.2.0)
您可以使用 npx @framy2/ctxwise mcp-xray --probe-stdio 安全地探測標準輸入輸出 MCP 工具並分析 token 權重。透過 npx @framy2/ctxwise agents --fail-on-divergence,您可以檢查 CLAUDE.md、.claude/rules/*.md、AGENTS.md、.cursor/mcp.json 和 .vscode/mcp.json 之間的一致性。
此外,npx @framy2/ctxwise shield --strict --sarif ctxwise.sarif 可以掃描洩漏的秘密、特洛伊木馬 Unicode、disableAllHooks 設定以及未釘選的 npx -y MCP 執行器。
最後,npx @framy2/ctxwise budget 可以在 Claude、Codex 和 Cursor 之間強制執行 ctxwise.budget.yaml 預算,而不會重複計算同步規則。
3. 精確找出每個回合的快取遺失 (@framy2/agent-wire-tap v0.2.0)
您可以使用 npx @framy2/agent-wire-tap --assert-contains "AGENTS.md" --assert-not-contains "sk-ant-" --assert-max-bytes 32768 --assert-max-tools 12 -- codex exec "ping" 進行 CI 合約測試,且 API 成本為 $0.00(模擬模式)。
作為一個即時透明的直通代理,npx @framy2/agent-wire-tap --passthrough https://api.anthropic.com --port 8787 會串流 SSE 並逐塊偵測前綴分歧。
--passthrough 會嚴格將憑證保留在記憶體中(在追蹤/日誌中顯示為 [REDACTED]),同時對每個前綴區段(模型、工具、系統、訊息)進行雜湊處理。當突變破壞 cache_control 斷點時,它會標記確切的 firstDivergentLayer / firstDivergentIndex。
試用客戶端計算器
您可以直接在瀏覽器中貼上您的 .mcp.json、.vscode/mcp.json、CLAUDE.md 或 AGENTS.md 檔案,這是一個 100% 本地運行的工具,不會上傳任何資料。請前往 https://framy2.github.io/ctxwise/ 體驗。