用 Claude Code、Cursor 这些客户端,但模型绑死海外?mcp-bridge 把 DeepSeek、通义、智谱、Kimi 统一接成一个 MCP 服务:客户端只配一次,断网自动回落到本机模型,每次调用都记成本。
直接拿资料:配置生成器(选两下出 JSON) · 国内用不了模型?排查顺序 · MCP 接国内模型配置全流程 · 技术文章(PDF,4 页) · 故障速查卡 · 装机速查卡
下面这段不是截图,是真实会话记录(客户端 → 服务端 → 模型 → 回执)。
# 客户端调用
{"name":"bridge_chat","arguments":{"provider":"local","prompt":"只回四个字:链路已通","project":"ACME-官网"}}
# 服务端回执
{"content":[{"type":"text","text":"{\"text\": \"链路已通\", \"model\": \"qwen2.5vl:3b\",
\"latency_ms\": 63, \"cost_cny\": 0.0}"}]}
# 看账(按项目分)
$ python server.py --report 7 --group-by project
最近 7 天调用:19 次,tokens 合计 351,花费 ¥0.0000
key calls tok_in tok_out cost_cny avg_ms
(未标记) 17 208 105 0.0000 171
BETA-客服 1 11 8 0.0000 0
ACME-官网 1 11 8 0.0000 0
四处配置管住四家模型。key 走环境变量,不写死在文件里;本地端点自动发现已装模型名。
每次调用落一条本地记录:token、成本、延迟、失败原因。可按项目/客户分账,数据不出你的机器。
上游不通时自动落到本机 ollama,并在回执里明确标注降级——不假装成功。
没有遥测、没有上报接口;key 走环境变量,账本是本地 SQLite,请求直连你配置的端点。
| 项 | 状态 |
|---|---|
| MCP 协议链路 | 7 项自检全过(initialize / tools/list / chat / cost / usage / 错误路径) |
| 真实上游调用 | 已跑通(本机 ollama,返回「链路已通」,冷启 4.2s / 热 70ms) |
| 按项目分账 | 已跑通 |
| 云端 provider | 未验证:本机没有云厂商 key,只有 mock 与错误路径被测过 |
| 流式输出 | 尚未实现(v0.4) |
没做到的事写在上面,比藏起来强。
MIT 协议,没有付费版,没有功能阉割,也没有"高级支持请打款"。代码在这儿,装不装随你。
| 你在意什么 | 这里怎么做的 |
|---|---|
| 能不能自己看明白 | 单文件 Python,只用标准库,22 KB 正文;协议、路由、成本核算都在里面,没有隐藏层。 |
| 装坏了怎么办 | --doctor 17 项体检 + 7 项协议自检;卡住了开 issue 或发邮件,免费的。 |
| 数据会不会外流 | 没有遥测。key 走环境变量,账本是本地 SQLite,请求直连你自己配的端点。 |
| 以后涨价吗 | 不会。MIT 授权不可撤回,已发布的版本永远免费。 |
如果你确实需要有人把这套装进你的环境,可以写邮件问;那是例外,不是产品。
因为它现在是我拿得出手的作品,不是货架上的商品。免费能换来更多真实使用和反馈,比收几笔钱有用。
默认路径就是本机或你内网的端点;用量账本存在本地 SQLite,不上传。
任何支持 MCP 的:Claude Code、Cursor、Cline、Continue 等。配置片段由安装脚本直接生成。
跑 python report.py 生成脱敏报告,发到 issue 或邮箱;能远程看出来的我直接说怎么改。