
CtxWise 发布:为 Claude Code 等工具清理 MCP 膨胀与上下文泄漏
来源标题:Show HN: CtxWise – Stop 8MB MCP crashes, schema bloat, and cache misses
CtxWise 是一款本地优先的 AI 上下文防火墙与 MCP Schema 精简工具,可避免启动时消耗 3 万以上 token。它支持分析 MCP 工具 schema、审计 CLAUDE.md 与 AGENTS.md 的一致性、扫描密钥泄漏,并通过 npx 零配置运行,适配 Claude Code、OpenAI Codex 和 Cursor。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
别再把 3 万多个启动 token 浪费在臃肿的 MCP 工具 schema、彼此不一致的 CLAUDE.md / AGENTS.md 文件,以及隐藏的 prompt 泄露上了。
面向 Claude Code、OpenAI Codex 和 Cursor 的本地优先 AI Context 防火墙、MCP Schema Tree-Shaker 和 Token 分析器。
⚡ 30 秒快速上手 · 📊 前后对比 · 🌳 MCP Tree-Shaker · 🛡️ 安全防护盾 · 🤖 GitHub Action · 🤝 5 分钟 PR
💡 你在用 Claude Code、OpenAI Codex 或 Cursor 吗?去 GitHub 上点个 ⭐ Star,这样当你的 MCP server 或 CLAUDE.md / AGENTS.md 文件开始撑爆上下文窗口时,你就能随时找到 CtxWise!
零配置、零 API key、零模型调用。在任何仓库里直接用 npx 运行:
1. 分析 MCP server,找出正在悄悄吃掉你上下文窗口的臃肿工具 schema
npx @framy2/ctxwise mcp-xray --probe-stdio
2. 审计启动 token,并检查 Claude Code(CLAUDE.md)、Codex(AGENTS.md)与 Cursor 之间的一致性
npx @framy2/ctxwise agents
3. 扫描上下文文件和 skill,检查泄露的 API key、prompt injection 和隐藏的 Trojan Unicode
npx @framy2/ctxwise shield --fail-on-risk
4. 在 CLAUDE.md <-> AGENTS.md <-> Cursor rules 之间同步,并应用无损的 Token Diet 压缩
npx @framy2/ctxwise sync --compress --cursor
现代编码 agent(Claude Code、OpenAI code CLI、Cursor)在每一轮对话中都会加载 CLAUDE.md、AGENTS.md、.cursor/rules、skill 目录,以及每个已连接 MCP server 的 JSON schema:
flowchart LR subgraph Sources["Active Agent Context Surface"] C["Claude Code\nCLAUDE.md · .mcp.json · .claude/skills"] O["OpenAI Codex\nAGENTS.md · config.toml · .codex/skills"] U["Cursor\n.cursorrules · .cursor/rules/*.mdc"] end subgraph Engine["CtxWise Local Engine (0 API Calls · <50ms)"] A["ctxwise agents & sync\nCross-Agent Parity + Token Diet"] M["ctxwise mcp-xray\nMCP Tool Schema Tree-Shaker"] S["ctxwise shield\nSecret & Prompt-Injection Firewall"] B["ctxwise budget & drift\nDeterministic Lock & CI Gate"] end Sources --> Engine Engine --> Out1["Lean, Synced Context\n(-29% to -73% Token Overhead)"] Engine --> Out2["GitHub Action CI Gate\nuses: FramY2/ctxwise@v1"] Loading
🔥 核心功能
- 🌳 MCP Schema Tree-Shaking(mcp-xray)
发现所有声明在 .mcp.json、.cursor/mcp.json、.vscode/mcp.json(VS Code 的顶层 "servers" 键)、~/.claude.json 和 ~/.codex/config.toml 中的 MCP server。精确测量每个工具 schema 的 token 权重(从已保存的 tools/list JSON 文件,或通过实时探测本地 stdio server 获取),并标记出 [BLOATED] 工具(≥ 250 token 或 ≥ 12 个输入属性):
npx @framy2/ctxwise mcp-xray --probe-stdio CtxWise mcp-xray · 3 MCP servers declared · 18 tool schemas analyzed · ~6,420 schema tokens (estimated) Heaviest MCP tool schemas:
- ~890 tokens · github/create_or_update_pull_request (16 params, 3,560 chars) [BLOATED]
- ~640 tokens · postgres/execute_migration_plan (14 params, 2,560 chars) [BLOATED] Tree-shaking potential: ~1,530 tokens/turn savable by pruning bloated tools.
- 🔄 多 Agent 上下文审计与 "Token Diet" 同步(agents & sync)
让 Claude Code(CLAUDE.md、.claude/rules/、.claude/skills、.claude/commands、.mcp.json)、OpenAI Codex(AGENTS.md、.codex/skills)和 Cursor(.cursor/rules/*.mdc)保持 100% 一致,同时剔除 markdown 中的冗余内容(HTML 注释、重复的条目规则、空白填充),且不碰围栏代码块。在 CI 中,当 CLAUDE.md 和 AGENTS.md 出现偏差时,ctxwise agents --fail-on-divergence 会以退出码 1 结束:
npx @framy2/ctxwise agents npx @framy2/ctxwise agents --fail-on-divergence npx @framy2/ctxwise sync --compress --cursor
- 🛡️ 上下文安全防护盾(shield)
在 agent 读取你的工作区之前,或在 PR 合并之前,保护你的仓库:
npx @framy2/ctxwise shield --fail-on-risk --sarif ctxwise.sarif
- 📦 精选技术栈预设(preset)
一条命令即可为你的技术栈生成可审查的 token 预算(ctxwise.budget.yaml),以及精简的起始 AGENTS.md + CLAUDE.md 文件:
npx @framy2/ctxwise preset npx @framy2/ctxwise preset nextjs-typescript --with-guidance npx @framy2/ctxwise budget --fail-on-exceed # auto-loads ./ctxwise.budget.yaml
ctxwise budget 覆盖 Claude Code、Codex 和 Cursor 的启动文件。默认(--agent all)情况下,限额作用于最重的单个 agent 会话,因此同步后的 CLAUDE.md + AGENTS.md 组合不会被重复计算;用 --agent codex|claude|cursor 可针对单个 agent 设置预算。
用 5 行代码把 CtxWise 加入 .github/workflows/ci.yml,即可在每个 Pull Request 上自动拦截密钥泄露、prompt injection 和上下文 token 膨胀:
- name: AI Context Firewall & Token Budget Guard uses: FramY2/ctxwise@v1 with: max-known-tokens: "4000" fail-on-secrets: "true" check-agent-parity: "true" sarif-file: "ctxwise-shield.sarif"
当 ./ctxwise.budget.yaml 存在(或 budget-policy 指向某个策略文件)时,Action 会使用它而不是 max-known-tokens。check-agent-parity: "true" 会运行 ctxwise agents --fail-on-divergence,并且每次运行都会把一个 Markdown 报告(防护盾状态、各 agent 的 token 明细、预算状态)追加到 job summary 中。
CtxWise 自带一个原生 Claude Code 插件清单(.claude-plugin/plugin.json + .claude-plugin/marketplace.json),用于安装 ctxwise skill:
/plugin marketplace add FramY2/ctxwise /plugin install ctxwise@ctxwise
🧩 配套工具 / 生态
FramY2/mcp-diet(@framy2/mcp-diet):零依赖的 stdio MCP 代理与运行时防火墙——确定性的 tools/list tree-shaking(--allow、--deny、--read-only、--max-desc)、超大 tools/call 崩溃防护(--max-result-kb,参见 example/feedback#105703),以及实时凭据脱敏(--redact-secrets)。
FramY2/agent-wire-tap(@framy2/agent-wire-tap):面向编码 agent(codex、claude)的零成本本地回环 HTTP 拦截器与 CI 契约测试工具——捕获精确的出站 wire payload,并以 $0.00 的 API 成本验证 system prompt、工具数量和字节预算契约。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。