在本地模型(如 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 配合使用,共同解决上下文窗口被工具定义和结果填满的问题。