配 MCP、接国内模型,卡在某一步出不来。这种情况我能帮上忙,而且不收费——先看清楚问题在哪,比什么都重要。
如果你已经在用 mcp-bridge,这三条就够我定位:
python test_stdio.py # 协议自检,七项 python server.py --doctor # 环境体检,十七项(重点) python server.py --report 1 # 账本里有没有记录
没用过也没关系。把你在客户端里看到的报错原文贴出来,加上系统版本和客户端名字,我照样能猜个八九成。
--doctor 的完整输出(十七行,别删减,WARN 也有信息)有些东西不用发:API key(打码或者删掉)、你的配置里的私密地址、任何客户数据。诊断用不着这些。
如果已经装了解压包,跑这一条:
python report.py
它会把系统信息、体检输出、自检结果、客户端配置状态整理成一个 txt 文件,**并且自动脱敏** key、token 和路径里的用户名。生成完直接贴过来就行,不用你组织语言。
两个地方,你顺手哪个用哪个:
我一般在 24 小时内回,回的是"哪一层出的问题 + 下一步做什么",不是"欢迎使用我们的产品"。
401 / 鉴权失败。九成是 key 没进客户端进程——系统环境变量和程序自己的环境变量是两回事。用 curl 直连打一次,通了就是客户端的问题。
Model not available / 404。模型名对不上。教程里的名字经常过期,直接问服务端要:curl $BASE/models,把返回的 id 原样填回去。
一直转圈然后超时。HTTP/2 协商失败也会这样,报错里一点线索没有。把客户端的 HTTP 兼容模式切到 1.1 试一次,这一步不改任何配置,试错成本是零。
诊断免费,动手配通是收费的:¥499,三小时一对一,跑不通不收费。有些问题打字说不清,共享屏幕十分钟比来回十封邮件快。
详情在项目主页的报价那一段。
—— 海桥,做模型接入层。开源版免费,诊断免费。真要收钱的地方会提前说。