在本地模型(如 Ollama、LM Studio、vLLM 或 llama.cpp)的 MCP 工具調用場景中,引入多個 MCP 服務器會導致工具定義迅速佔滿上下文窗口。Tool Guardian 作爲 MCP 路由層,通過減少顯式的工具定義,緩解這一問題。
是什麼¶
Tool Guardian 是一個 MCP 路由工具,它位於你的 MCP 服務器前端,將原本數十個特定的工具定義替換爲 6 個通用工具(配合 Skills 爲 8 個)。它通過“按需發現”機制,防止工具定義在模型讀取內容前填滿窗口。
該插件由 LuminariSoftwares 維護,提供 DeepSeek Harness 原生 Bundle,旨在解決工具調用導致的上下文溢出問題。
核心功能¶
- MCP 路由:統一管理多個 MCP 服務器的入口。
- DeepSeek Harness 原生 Bundle:作爲 DSH 插件直接集成。
- 工具 Schema 優化:通過漸進式披露減少初始上下文佔用。
- 工具結果歸檔:將工具結果存檔,避免結果在對話窗口中堆積。
- 工具組成本計算:對工具調用進行成本統計。
- 漸進式披露:僅在模型需要時展示特定工具。
安裝¶
使用官方安裝命令將 Bundle 添加到 DSH 配置中:
dsh plugin --profile web add dsh-tool-guardian
注意事項與兼容性¶
安裝前請確保環境滿足以下依賴要求:
* DeepSeek Harness (DSH): 0.1.2-alpha.2 或更高版本
* Node.js: ^22.19 或 >=24
* Python: 3.9+
該插件兼容以下客戶端環境:
* Claude Code
* OpenCode
* Cline
* Continue
價值總結¶
Tool Guardian 將原本約 20,005 tokens 的工具定義壓縮至 1,209 tokens,並支持工具結果的按需歸檔與調用。它與 Context Guardian 配合使用,共同解決上下文窗口被工具定義和結果填滿的問題。