这篇记录更新了项目判断 / MCP Slim Guard
MCP Slim Guard Alpha：减少 76% MCP Token，并保留精确恢复
从工具发现、一次上游执行到 read_result 恢复，记录 MCP Slim Guard Alpha 的交付机制、24 项任务基准和当前 Host 支持。
MCP 工具目录和超大结果会占用 Agent 上下文。直接截断又会丢掉后续核对和继续处理需要的原始内容。
MCP Slim Guard 先把符合条件的 MCP 内容紧凑交付给 Agent，同时保存一份不可变快照。Agent 需要原文时，read_result 直接读取快照。一次上游调用贯穿整个过程。
一次上游调用，两种结果交付
当前 Alpha 提供两个接入表面：
- Generic：通过
find_tool、call_tool和read_result渐进发现并调用工具。 - Native：保留 Host 已授权的原始工具名，并在结果交付阶段决定直通或紧凑交付。
两条路径共用一份交付契约。Slim Guard 原样传递选定参数，每次请求只执行一次上游工具。符合条件的长文本、结构一致 JSON 和日志类结果会生成紧凑视图，其他结果沿用上游格式。
紧凑视图带有恢复引用。read_result 通过引用读取不可变快照，上游调用数仍为一次。
标准基准：71,388 → 17,007 Tokens
冻结的标准基准包含 12 个确定性工具和 24 个中英文任务，使用 o200k_base 计算 MCP 暴露内容与正常任务路径的 Token：
| 指标 | 直接接入 | MCP Slim Guard |
|---|---|---|
| 正常路径 Token | 71,388 | 17,007 |
| 完成任务 | 24/24 | 24/24 |
| 上游调用 | 24 | 24 |
正常路径减少 76.18% MCP Token，24 个任务全部完成，每个任务调用一次上游工具。
完整 fixture、o200k_base 计数方式和逐任务结果都在 双语 Alpha 基准方法 中。
另一个 100 工具、8,000 行结果的合成压力测试记录了 99.7% 的上限，用于观察极端目录与结果规模下的交付行为。
当前 Host 支持
| Host | 当前 Alpha 表面 |
|---|---|
| Codex | Native 优先，Generic 回退 |
| Claude Code | Generic |
| VS Code | Preview |
| OpenCode | Alpha 之后 |
Slim Guard 专注于可逆的 MCP 结果交付。授权、精确路由和审计服务于这条交付路径。
安装 Alpha
$ pnpm add -g mcp-slim-guard@alpha
不同 Host 的配置方式、迁移与回滚步骤以 GitHub README 为准。当前发布版本为 0.1.1-alpha.1，需要 Node.js 20 或更高版本。
相同的上游调用，精确恢复原始结果。