跳到主要内容
Plugin

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 包安装 · 需要额外配置密钥

README 解析
shell
dsh plugin --profile web add dsh-tool-guardian
shell
dsh plugin --profile web add dsh-context-guardian
shell
npm 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%
评分怎么算