token-optimizer-mcp
在 Headroom 自身基準測試中,工具輸出減少了 91.5% 的 token,而 Headroom 減少了 61.4%。另外,相同 SWE-bench 任務的解決成本為純 Claude Code 的 0.71 倍。
token-optimizer-mcp 是什麼?
在 Headroom 自身基準測試中,工具輸出減少了 91.5% 的 token,而 Headroom 減少了 61.4%。另外,相同 SWE-bench 任務的解決成本為純 Claude Code 的 0.71 倍。加上跨工作階段的記憶體與訂閱配額調控。支援 Claude Code、Codex、Copilot、Gemini 及另外 12 種工具。本地執行,MIT 授權。
token-optimizer-mcp 概覽
這是什麼
Token Optimizer MCP 是一個開源工具,可將 AI 編碼代理的 token 用量減少高達 91.5%(工具輸出部分)。它作為外掛、代理和 MCP 伺服器,支援 16 種客戶端,包括 Claude Code、Codex、Copilot、Gemini 和 Cursor。所有功能都在本地執行,無需帳號或託管服務;除非明確選擇加入兩次,否則遙測功能關閉。在 SWE-bench Verified 上,使用預設模式的 Claude Code 外掛以 0.71 倍成本解決相同任務(兩組皆解決 7/7;九次執行中,無外掛解決 84 項任務,有外掛解決 83 項)。本專案採用 MIT 授權。
主要功能
- 在昂貴呼叫發生前攔截,將過大的讀取、搜尋或 grep 導向快取、有界限的替代方案,或在強制模式下直接拒絕。
- 透過專案專屬的知識圖譜記住代理跨工作階段的發現,將決策和死路作為正常工作的副產品收集起來。
- 壓縮無法避免的工具輸出、日誌、JSON 和搜尋結果,並針對提示快取最佳化(供應商對快取前綴收費 0.1 倍,對重寫部分收費 1.25 倍)。
- 自我測量節省的 token 量,並在虧損時回報,節省量會記錄前後差異,並按客戶端和操作歸因。
- 支援 16 種客戶端:其中 10 種可拒絕浪費的呼叫;6 種使用永遠開啟的路由規則。
- 提供本地儀表板,為每個代理、每次節省和最佳化器本身的成本建立單一分類帳。
使用情境
降低軟體開發工作流程中 AI 編碼代理的 token 成本。適合使用 Claude Code、Codex、Copilot CLI、Gemini CLI、Cursor 或任何 16 種支援客戶端的團隊,希望在不解任務完成率的情況下降低 API 花費。也可透過知識圖譜功能跨工作階段維持上下文。
快速開始
Claude Code. 安裝外掛而非純 MCP 伺服器:text/plugin marketplace add ooples/token-optimizer-mcp/plugin install token-optimizer@token-optimizer/reload-plugins需要 Node.js 22.14 或更新版本(位於 Claude Code 的 PATH 中),以及 Claude Code 2.1.139 或更新版本。然後檢查是否正常運作:bashnpx token-optimizer-doctorCodex、Copilot CLI、Gemini CLI、Cursor 及其他客戶端。 所有客戶端執行相同的伺服器:textnpx -y @ooples/token-optimizer-mcp@latest每個客戶端的預設設定位於 src/integrations/,docs/INSTALLATION.md 詳細說明全部 16 種客戶端的安裝方式。
授權與價格
授權:MIT。價格:開源(免費)。
內容整理自該專案公開的 README 與儲存庫資訊。