
DoboCache
MCP server for LLM prompt-cache observability: prefix diagnostics and per-call white-box report.
- tools
- 9
- transport
- STDIO
- env vars
- 4
- last updated
- Nov 7, 2026
Tools
9 toolsPublic tool metadata for what this MCP can expose to an agent.
cf_judge命中判定:关键词分层(实体锚词/意图修饰词)→ 三层匹配 → 时效衰减 → 负向过滤,输出可解释证据(hit / score / evidence / matched)
命中判定:关键词分层(实体锚词/意图修饰词)→ 三层匹配 → 时效衰减 → 负向过滤,输出可解释证据(hit / score / evidence / matched)
No parameter schema in public metadata yet.
cf_tier价值分级准入:提纯去噪 → A/B/C 分级 → 按预算从高到低填充,输出准入列表与丢弃明细
价值分级准入:提纯去噪 → A/B/C 分级 → 按预算从高到低填充,输出准入列表与丢弃明细
No parameter schema in public metadata yet.
cf_inject记忆提纯注入:把上下文整理成稳定前缀(去重 → 128 token 对齐 → 过门槛补足),返回可直接发送的 prefix / tail
记忆提纯注入:把上下文整理成稳定前缀(去重 → 128 token 对齐 → 过门槛补足),返回可直接发送的 prefix / tail
No parameter schema in public metadata yet.
cf_warmup预热:正式请求前显式调用一次,用冻结前缀构造最小占位请求,触发厂商前缀缓存建立
预热:正式请求前显式调用一次,用冻结前缀构造最小占位请求,触发厂商前缀缓存建立
No parameter schema in public metadata yet.
cf_report白盒累计统计:累计命中率、原始/优化 token、按会话聚合,并回传日志实际落点 logDir / logDirSource;加 source="disk" 时改为从本地日志重新聚合
白盒累计统计:累计命中率、原始/优化 token、按会话聚合,并回传日志实际落点 logDir / logDirSource;加 source="disk" 时改为从本地日志重新聚合
No parameter schema in public metadata yet.
cf_meter请求计量快照(token 计数与计价相对值,不含任何请求正文)
请求计量快照(token 计数与计价相对值,不含任何请求正文)
No parameter schema in public metadata yet.
cf_prune工具输出确定性修剪:去重行、压缩空白、行数/字符数双上限,返回修剪前后体积比
工具输出确定性修剪:去重行、压缩空白、行数/字符数双上限,返回修剪前后体积比
No parameter schema in public metadata yet.
cf_normalize结构化结果归一:字段裁剪 + 稳定排序,返回不含原文的键值(nk-<16 位 hash>)
结构化结果归一:字段裁剪 + 稳定排序,返回不含原文的键值(nk-<16 位 hash>)
No parameter schema in public metadata yet.
ping健康检查
健康检查
No parameter schema in public metadata yet.
Sponsors
Configuration
DOBOCACHE_LOG_DIRDirectory for the local white-box JSONL log. Absolute path recommended. Optional; defaults to the platform log directory: %LOCALAPPDATA%\DoboCache\logs on Windows, ~/Library/Logs/DoboCache on macOS, $XDG_STATE_HOME/dobocache (fallback ~/.local/state/dobocache) on Linux.
DOBOCACHE_WHITEBOXWhite-box report card mode: quiet (default, no card in tool output, log only), once (one card next call, then back to quiet), always (card on every call, ~300+ tokens each). Unrecognized values fall back to quiet with a warning. Cumulative stats are always available via cf_report
DOBOCACHE_HIT_PRICE_PER_MOptional price per million tokens for cache-hit tokens used in savings estimates.
DOBOCACHE_MISS_PRICE_PER_MOptional price per million tokens for cache-miss tokens used in savings estimates.
Readme
DoboCache v0.6.0 · dobostitch:同一缓存内核,三种挂法
同一个会话,别为同一段上下文反复付全价。 把请求前缀稳定下来,让你已经在付费的**厂商前缀缓存(prompt caching)**真正命中:第一次请求照常建缓存,从第二次起基本按缓存价走。全程本地运行,不联网、不上报。
先说你是不是碰到过这三种情况
| 症状 | 真实原因 |
|---|---|
| 同一个会话越问越贵 | 前缀一变,厂商那段缓存整段作废,后面每次都在全价重算 |
| 长会话突然"忘事"、答非所问 | 客户端自动压缩或裁剪切掉了历史,切完的前缀对不齐缓存块边界 |
| 换客户端 / 改了提示里的一个字,命中率直接归零 | 头部的时间戳、随机 ID、工具数组顺序不稳,前缀第一段就变了 |
这三件事不是"模型不行",也不全是厂商缓存不行——卡点只有一个:前缀稳不稳。 厂商缓存本身很好用,前缀稳的时候能吃到接近 99%;DoboCache 做的是把这件"靠运气"的事变成每次请求都发生,并且把每一步做了什么写成本地日志,让你能自己核对,而不是只看一个漂亮数字。
30 秒上手(一条命令,自己接上)
npx -y dobocache dobostitch setup
它按顺序做四件事,屏幕上都会打出来:
- 识别你电脑上装了哪些 AI 客户端(开箱即扫,不需要你指定路径);
- 每个客户端的配置先备份、再改;
- 把「能自动带起本地代理」的入口写进客户端的 MCP 配置;
- 注册开机自启(登录后自动起代理)。
跑完重启客户端即可。不用改 baseURL、不用写脚本、不用另起进程——MCP 入口被拉起时,本地代理会自己跟着起来。换客户端时再跑一次这条命令即可,已接好的会显示「已是接入状态」,幂等不重复改。
跑完想确认真的接上了:
Details
- Repository
- github.com/dobo123123/dobocache
- Website
- github.com/dobo123123/dobocache
- Categories
- AI & LLM Tools, Monitoring & Observability
- Package
dobocache- Transport
- STDIO
- Registry
- MCP registry, active