MCP Context Budget

MCP Context Budget 是一款本地优先、MIT 许可的 CLI 工具，专为控制 MCP（Model Context Protocol）上下文膨胀而设计。它能够精确测量 MCP 服务器和工具消耗的上下文量，自动筛选出精简且任务相关的工具集，生成锁定文件，并在 CI 流程中当 schema 或响应 token 预算出现退化时触发失败。

核心功能

• 上下文测量：自动分析 MCP 服务器和每个工具的上下文占用，量化 token 消耗。
• 工具集精简：基于当前任务需求，从可用工具中挑选最相关、最轻量的子集，避免冗余上下文。
• 预算锁定：生成 lockfile 记录当前工具集的上下文预算，确保后续变更可追溯。
• CI 集成：在持续集成流水线中执行预算检查，当 schema 或响应 token 预算超出阈值时立即失败，防止性能退化。

主要特性

• 本地优先：所有计算在本地完成，无需依赖云端服务，保障数据隐私。
• 开源免费：采用 MIT 许可证，可自由使用、修改和分发。
• 精准控制：通过细粒度的预算管理，避免代理因上下文膨胀而失控。
• 易于集成：作为 CLI 工具，可无缝嵌入现有开发工作流和 CI/CD 管道。
• 可追溯性：lockfile 机制让每次预算变更都有记录，便于团队协作和审计。

适用场景

• AI 代理开发：在构建基于 MCP 的智能代理时，确保上下文使用在可控范围内。
• CI/CD 质量门禁：作为自动化检查步骤，防止上下文预算意外增长。
• 性能优化：识别并消除不必要的上下文消耗，提升代理响应速度。
• 团队协作：通过锁文件统一团队上下文预算标准，避免各自为政。