tool-guardian
LuminariSoftwares/tool-guardian
用三个路由工具(list_capabilities、describe_tool、call_tool)代理 stdio MCP 服务器,schema 按需加载,不再随每次请求发送;所有工具结果经过确定性输出阶梯压缩,有损处理前先归档原文(retrieve_spill 可读回);按 token 为工具分组标价,并可按 agent 隐藏内置分组。桥接到纯标准库的 Python 路由器,需要 Python 3.9+。
- 形态
- Plugin 插件
- 安装
- npm 包安装
- 需要密钥
- 是
- 近月下载
- 3,234
- 最近推送
- 昨天更新
项目说明
From README
Tool Guardian Status: active development -- changelog mcp-name: io.github.LuminariSoftwares/tool-guardian Seven MCP servers for 1,084 tokens instead of 20,005.One MCP server in front of all your others, so the model fetches a tool schema only when it needs one.
Quick start (60 seconds) Nothing to install: uvx runs it from PyPI.The example server below is the MCP filesystem server, which runs with npx , so that one line needs Node.js — the router itself is Python 3.9+ and standard library only.
Or tell your coding agent: Install tool-guardian (docs: and route my MCP servers through it.Prefer it installed?pip install tool-guardian , then drop the uvx prefixes ( tool-guardian-setup add ..., tool-guardian --selftest ).Success looks like added 'files' to /.tool-guardian/mcp.
json , then from --selftest 1 backend(s) up, 14 tools reachable.and a router tools cost N tokens vs M line.Alrea
Original description
Too many MCP servers eating your context? tool-guardian sits in front of all of them and loads each tool's schema only when it's needed. A 7-server setup went from 20,005 tokens to 1,084. Works with any MCP client.
安装方式
npm 包安装 · 需要额外配置密钥
dsh plugin --profile web add dsh-tool-guardiandsh plugin --profile web add dsh-context-guardiannpm run setup # asks before it writes ~/.tool-guardian/mcp.json, then prints a doctor report安全能力
静态扫描源码得到的权限画像 —— 回答的是「它要动什么」,而不是「它好不好」
- 执行命令
- 写入文件
- 读取文件
- 读取环境变量
未发现已知红线(明文传输、安装期执行代码、凭据外传等)。
能力与红线来自 awesome-dsh-plugin 的静态扫描结果(CC0 公有领域),本站未逐行复核源码; 它只覆盖能被静态识别的模式,不等于安全审计结论。
为什么是这个分数
近 2 天仍在推送;README 给出了可直接复制的安装命令;运行前需要准备 API Key 或环境变量;近月 npm 下载 3234 次,star 不多但真在被使用。
- 维护活跃
- 100
- 实用度
- 100
- 生态热度
- 70
- 上手便捷
- 74
- 信号质量
- 100
- 数据置信度
- 100%
相关插件
context-guardian
LuminariSoftwares/context-guardian
为 compaction-basic 提供压缩兜底:当 LLM 摘要抛错、返回空内容或放不进上下文窗口时,改为确定性编译该区段,每行带 seq 指针(内置 dsh-compaction-instant 编译器)。提供 recall、search 工具与 /recall、/context 命令,占用超过窗口 45% 时空闲自动压缩,并将被压缩区段归档到磁盘。引擎以一行配置挂载到 agent preset(见 docs/dsh-integration.md)。
dsh-toolgate
jidekaixin2dian/dsh-toolgate
管理 MCP 服务器与 Skill,并控制下一轮 prompt 带入哪些工具。
dsh-context-guard
2JumpSinA/dsh-context-guard
长会话越跑越贵,平台到点还会把上下文压掉。这个插件做三件事:在会话标题旁显示当前上下文占了多少,鼠标停上去能看到这个数是怎么来的;过 45% 时往工作目录的 HANDOVER.md 写一份交接草稿,记下改过哪些文件、花了多少钱、最近几轮在聊什么;到 60% 提醒你一次该收尾了。平台压缩发生时,它把压缩前的数字记一行,事后还查得到。不调用模型,也不改动对话内容。它不阻止压缩,拿不回已经被压掉的部分。