零依赖 · Python 3.8+ · 本地用量账本

把国内模型接进
你的 agent

用 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 或邮箱;能远程看出来的我直接说怎么改。