MCP Slim Guard

上下文里读短的,细节仍然找得回。

工具结果往往很长,但下一步未必用得上全部内容。MCP Slim Guard 先给出紧凑结果,完整内容保存在可恢复的快照里。

本文目录

简短结果与完整原文,来自同一次调用。

读者查看从书匣连续展开的折页,手中的一页仍与完整书册相连。

一千条记录,先看紧凑视图。

这组数据由测试脚本生成,用来核对紧凑交付与原文恢复。下面节选原始 JSON 和实际交付的表格内容。

原始 JSON

[
  {
    "id": 0,
    "state": "open",
    "owner": "team-0"
  },
  {
    "id": 1,
    "state": "closed",
    "owner": "team-1"
  }
]

完整结果含 1,000 条记录,此处节选前两条并换行排版。

紧凑视图

idstateowner
0"open""team-0"
1"closed""team-1"

字段名只写一次。实际视图展示前 57 条,其余 943 条通过 read_result 取回;此处节选前两条。

查看 id 为 500 的原文记录

这条记录不在首次视图中。测试记录显示,一次 read_result 读取便找到它;下面按原始测试数据展示该记录。

{
  "id": 500,
  "state": "open",
  "owner": "NEEDLE:uniform-json"
}

另一次完整恢复检查共读取两次,恢复内容与原始内容完全一致。

确定性测试 · 2026-07-26下载测试记录节选查看原始数据定义

如何工作

给 MCP 输出占满上下文的工作流

一次调用,得到完整结果

执行一次获准的上游工具调用。

交付紧凑视图

适用的大结果先缩短,附上恢复引用。

进入 Agent 上下文

先阅读,继续当前任务。

保存原文快照

保留同一次调用的完整结果。

需要细节时取回

read_result 通过恢复引用读取快照。

两条路径来自同一次调用。取回原文只读取快照,不重新执行上游工具。其他不适用的结果保留上游交付格式。

一次调用,精确恢复。

冻结的标准基准包含 12 个确定性工具与 24 个中英文任务,使用 o200k_base 计算 MCP 交付路径。

正常路径 Token
71,388 → 17,007
确定性任务完成
24/24
上游调用
24

另一个 100 工具、8,000 行结果的合成压力测试达到 99.7% 上限。

查看基准说明

安装与支持

说明对应版本: 0.1.1-alpha.1

GitHub 保存开源 Alpha v0.1.1-alpha.1 的安装说明、Host 边界、基准方法和源码。

Codex 已支持 Native 优先、Generic 回退;Claude Code 支持 Generic 表面。VS Code 仍是预览支持,OpenCode 计划在 Alpha 之后接入。

GitHub 安装文档

常见问题

MCP Slim Guard 是什么?

MCP Slim Guard 是一个可逆的 MCP 结果交付运行时。当前 Alpha 会减少 Generic 表面的工具目录,以及 Generic 与 Native 表面中符合条件的大结果上下文。

它压缩哪些 MCP 内容?

它减少已授权的 Generic 工具目录,并紧凑交付符合条件的长文本、结构一致的 JSON 和日志类结果。其他结果沿用上游交付格式。

恢复结果会重新调用上游工具吗?

Slim Guard 保存一份不可变快照,read_result 直接读取它。恢复前后,上游调用都只有一次。

当前 Alpha 支持哪些 Host?

Codex 已支持 Native 优先、Generic 回退;Claude Code 支持 Generic 表面。VS Code 仍是预览支持,OpenCode 计划在 Alpha 之后接入。

它是通用安全网关吗?

MCP Slim Guard 专注于可逆的结果交付。授权、精确路由和审计服务于这条交付路径。

GitHub 安装文档

接着读

MCP Slim Guard Alpha:减少 76% MCP Token,并保留精确恢复

查看项目源码

返回项目介绍