1 v0.15.0 更新于 2026-11-05

Context Guardian MCP Server

40 turns: 1,130,722 tokens upstream -> 161,141. A fail-open compaction proxy for local models.

适用客户端

本地客户端

Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端

本地运行(pypi)

{
  "mcpServers": {
    "context-guardian": {
      "command": "uvx",
      "args": [
        "context-guardian"
      ]
    }
  }
}

将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。

guardian_status

查询运行中代理的实时状态（JSON）：窗口与预算、压缩次数、节省的 token、被拒绝的摘要、校准信息，只读本地 HTTP 请求。

search_spans

在压缩归档的对话文本中做大小写不敏感的纯文本搜索，返回命中行（span 文件、消息索引与角色、片段），最多 50 条。

read_span

读取一个归档的 span：压缩生成的摘要及其替换的原始消息，超长时截断（最多约 20000 字符）。