Balloon MCP服务器
Balloon MCP是一个MCP服务器，用于监控长AI会话中的上下文保真度。
服务器是围绕一个核心观察点设计的：长会话不仅会丢失事实，而且往往会失去用户意图的形状。Balloon将该问题转化为一个可见的运行时界面，其中包含配置文件、间隙报告、漂移压力摘要、检索锚点、纠正提示和可回放的工件。
一目了然：
- 确定性气球是稳定的基准锚
- assistant Balloon添加了可选的语义细化
- 舞台气球增加了早期、中期和深层的外部传球，以延长训练时间
气球为什么存在
人工智能会话往往以一种令人沮丧的微妙方式失败：
- 最新的答案在当地听起来很合理
- 但它悄悄地放弃了早先的限制、保护区或核查义务
- 用户现在必须手动将会话拖回正确的路径
这就是气球被造出来的问题。
对于开发人员来说，这通常看起来像：
- 当您要求进行有界的更改时，模型会建议进行广泛的重构
- 测试要求在会话中途消失
- 受保护的文件或架构选择被忽略，因为本地转向听起来似乎合理
Balloon旨在充当该故障模式的推理侧车。它并不试图成为神奇的代码生成。它试图使漂移可见，并在会话失去绘图之前施加较小的校正压力。
状态
此版本是早期的公开alpha版本。
它是气球架构的外部近似工作。确实如此 不 索赔：
- 封闭模型的隐藏状态访问
- 直接后端渗透到专有推理层
- 推理层内存植入
它的作用
Balloon MCP帮助主机应用程序：
- 构建结构化会话配置文件
- 审计最新的偏差和遗漏
- 对当前漂移压力进行评分，而不是仅列出原始间隙
- 表面隐藏的要求和问题背后的问题
- 仅检索最相关的锚点
- 生成低容量、非覆盖的代理涓流
- 强化内存分类账中的重复上下文
- 促进反复向持久焦点转移，从而改变检索、涓滴排序和发布行为
- 将相似性匹配的更正从内存中释放出来，并滴入下一步
- 运行一个分阶段的外部原型，包括早期、中期和深层气球通行证
根据设计，服务器返回分析工件和纠正上下文。它不会自行修补您的仓库。
可选混合动力车道
除了确定性基础之外，Balloon现在还有一个可选的混合语义通道。
这意味着：
- 确定性气球保持稳定的基准锚
- 语义CARA可以作为影子或辅助模式启用
- 开发人员可以插入自己的模型支持适配器，而无需更改核心服务器
- 阴影模式和辅助模式都在当前烟雾路径中
- 辅助模式仍然取决于允许适配器进程执行的主机
分阶段外部原型
气球现在还包括第一阶段的外部原型。
这条分阶段车道仍然诚实地描述了MCP边界：
- 这是一种外部近似值，而不是隐藏状态访问
- 它在早期、中期和深层开放式气球阶段运行
- 它使用相似性门控释放来决定下一步中哪些内存/涓流校正应该保持可见
- 它为我们提供了超越基线、确定性和辅助性的第四条基准车道
看 docs/STAGED_EXTERNAL_BALLOON.md.
如果你只想要最短的心智模型：
- 基线漂移
- 确定性气球修复漂移
- 辅助气球改进措辞，限制下一步的质量
- 舞台气球在范围扩大之前增加了重新检查的纪律
为什么感觉不一样
一场好的气球赛本身并不是“更多的背景”。
它应该使一个特定的故障可见：
- 最新的答案在当地看来似乎是合理的
- 但它已经停止履行早先的限制、保护区或核查义务
- 气球表面会失去意图，并施加较小的矫正压力，而不是将整个过程塞回下一回合
- 反复出现的漂移现在可以成为持续关注的焦点，因此重复的架构或验证失败会更早地被拉入纠正路径
这使得第一次有用的体验更容易与以下内容联系起来：
- 你已经知道会议应该尊重什么
- 气球显示了掉落的东西
- 气球为下一个模型转弯提供了一种有界的恢复方式
核心入口点
了解服务器的最快方法是：
balloon_run_cycle
它运行主气球循环：
- 配置文件更新
- 隐藏需求检测
- CARA式差距审计
- 漂移压力评分
- 当相同的故障模式不断重复出现时，持续的漂移焦点
- 目标检索
- 代理涓流生成
- 可选记忆增强
协议表面
工具：
balloon_run_cycleballoon_build_profileballoon_audit_turnballoon_detect_hidden_requirementsballoon_targeted_retrievalballoon_generate_proxy_trickleballoon_repair_next_turnballoon_semantic_cara_previewballoon_compare_repair_lanesballoon_run_staged_cycleballoon_compare_benchmark_lanesballoon_score_benchmark_lanesballoon_run_long_session_benchmarkballoon_score_long_session_benchmarkballoon_prepare_host_setup_packetballoon_validate_host_setupballoon_run_install_diagnosticsballoon_prepare_host_flow_packetballoon_prepare_host_validation_suiteballoon_record_host_validation_resultballoon_summarize_host_validation_resultsballoon_describe_slopcode_starter_suiteballoon_plan_slopcode_starter_benchmarkballoon_prepare_slopcode_problemballoon_prepare_slopcode_live_run_packetballoon_prepare_slopcode_live_run_finalize_packetballoon_prepare_slopcode_live_run_batchballoon_finalize_slopcode_live_runballoon_finalize_slopcode_live_run_batchballoon_record_slopcode_run_evidenceballoon_summarize_slopcode_run_evidenceballoon_summarize_slopcode_starter_suiteballoon_export_slopcode_starter_artifactsballoon_review_session_driftballoon_update_memory_ledgerballoon_explain_gap_report
提示：
balloon/repair-next-turnballoon/review-session-drift
资源：
balloon://sessions/{sessionId}/summaryballoon://sessions/{sessionId}/profileballoon://sessions/{sessionId}/gapsballoon://sessions/{sessionId}/pressureballoon://sessions/{sessionId}/tricklesballoon://sessions/{sessionId}/memoryballoon://sessions/{sessionId}/releasesballoon://hosts/matrixballoon://hosts/{host}balloon://hosts/{host}/playbookballoon://hosts/{host}/validation-suiteballoon://hosts/{host}/validation-evidenceballoon://benchmark/slopcode/starter-suiteballoon://benchmark/slopcode/starter-suite/runbookballoon://benchmark/slopcode/live-run-playbookballoon://benchmark/slopcode/live-run-batchballoon://benchmark/slopcode/evidenceballoon://benchmark/slopcode/evidence/{problemName}balloon://benchmark/slopcode/problems/{problemName}
入门指南
- 读 docs/INSTALL.md
- 跑
npm run verify:balloon:mcp - 在中尝试工作流 docs/DEMO_WORKFLOW.md
目前推荐的真实主机测试是VS Code .vscode/mcp.json.
第一个演示
推荐的第一个演示故意很小：
- 前面的上下文说不要重写架构，也不要跳过测试
- 后来的助理自信地提出无论如何都要重写
- Balloon生成间隙报告、漂移压力总结、代理涓流和更清晰的下一个转弯修复路径
如果您的MCP主机在提示调用方面不可靠，请使用 balloon_repair_next_turn 作为工具级别的回退。它返回修复包和确定性修复回复，这使得演示和基准测试更具可重复性。
如果你想在不依赖提示路由的情况下获得漂移审查提示，请使用 balloon_review_session_drift.
如果你想直接比较确定性和混合修复输出，请使用 balloon_compare_repair_lanes.
如果您希望在不依赖提示路由的情况下进行分段外部近似，请使用 balloon_run_staged_cycle.
如果你想进行基准安全四车道比较，请使用 balloon_compare_benchmark_lanes.
如果你想在一个工具调用中进行检查点长会话比较，请使用 balloon_run_long_session_benchmark.
如果你想检查漂移压力是上升、下降还是在整个会话中保持不变，请阅读 balloon://sessions/{sessionId}/pressure.
如果您希望Balloon生成或健全性检查主机配置数据包，请使用 balloon_prepare_host_setup_packet, balloon_validate_host_setup, balloon_run_install_diagnostics, balloon_prepare_host_flow_packet, balloon_prepare_host_validation_suite, balloon_record_host_validation_result, balloon_summarize_host_validation_results，或 balloon://hosts/matrix.
如果您想要第一个真正的SlopCodeBench入门套件工作流，请使用 balloon_describe_slopcode_starter_suite 和 balloon_prepare_slopcode_problem.
如果你想让Balloon为你提供主机/问题对的完整实时重新运行包，请使用 balloon_prepare_slopcode_live_run_packet.
如果你想一次性准备好整个初学者套件的重新运行通行证，请使用 balloon_prepare_slopcode_live_run_batch.
如果您想粘贴一次最终成绩单并让Balloon对其进行评分，记录证据，并一次性导出工件包，请使用 balloon_finalize_slopcode_live_run.
如果你想在几次实际运行后一起刷新整个入门套件通行证，请使用 balloon_finalize_slopcode_live_run_batch.
如果您想要回购支持的SCBench摘要包，请使用 balloon_export_slopcode_starter_artifacts这些出口现在包括压力痕迹和现场与回放证据报道。
如果你想保持基准测试的诚实，记录跑步是否真的符合要求 balloon_record_slopcode_run_evidence，总结如下 balloon_summarize_slopcode_run_evidence，并检查 balloon://benchmark/slopcode/evidence.
如果演示感觉不错，重要的不是Balloon产生了更多的文本。重要的是，它保留了现有的方向，并将下一个回复推回到用户的实际约束中。
文档
- 安装
- 演示工作流程
- 当前准备状态
- 语义CARA
- 分段式外部气球
- 主机兼容性
- 主机验证
- 临床快速入门
- Roo代码快速入门
- 延迟和更正税
- 基准车道
- 长期基准
- SlopCodeBench入门套件
- 贡献者启动器
- MCP列表
- 架构路线图
- 贡献
- 安全策略
- 支持
视觉资产
- 应用程序/列表图标： docs/assets/balloo-mcp-icon.png
- README横幅： docs/assets/balloom-mcp-banner.png
- 分阶段讲解员图片： docs/assets/balloo-mcp-stages.png
- 简单标记： docs/assets/balloo-mcp-mark.png
适合
气球MCP在以下情况下最有用：
- 一场会议有很强的先验约束，这应该仍然很重要
- 一个在当地看似合理的答案可能仍在偏离早先的意图
- 可见的校正伪影比不可见的提示填充更有价值
不是索赔
这个公共alpha没有声明：
- 封闭模型的隐藏状态访问
- 直接后端渗透到专有推理层
- 回购范围内的架构审计作为主要的产品标识
当前的服务器是Balloon架构的外部近似值：CARA风格的差距分析、有针对性的检索和随着时间的推移实现上下文保真度的代理涓滴。