第 3 周 · D15🔒 锁定约 4 小时
接入 MCP:手写 JSON-RPC 客户端、两种传输与工具命名空间
把别人的工具接进自己的 Agent:不用官方 SDK,手写一个 MCP 客户端,跑通 stdio 与 Streamable HTTP 两种传输,把远端工具聚合进本地清单并加命名空间,最后让它们复用第五天那道审批门。
今日目标
- 能手写一个能完成初始化、列工具、调工具的 MCP 客户端
- 能说清 stdio 与 Streamable HTTP 两种传输各自的适用场景与失败模式
- 能把远端工具安全地聚合进本地工具清单,处理命名冲突与信任边界
前两周做的是一个自给自足的 Agent:每一个工具都是我们自己写的。第三周开始给它接外面的东西,第一站是别人的工具。读完回到页面顶部把三条目标勾掉。
小白版讲解
借用别的部门的工具间
前十四天,mca 会的每一件事都长在我们自己手里:读文件、改文件、跑命令、拍快照。今天要处理的是另一类需求——用户要它干的活,工具不在我们这儿。
比如:动手改代码之前先查一下团队笔记里有没有相关约定,改完之后看看工单系统里有没有对应的工单。这两样东西都不在这个仓库里,也不该由我们实现——笔记库是文档组维护的,工单系统是另一个部门的。
换成车间的说法:新人手边有自己的一套工具,但隔壁部门有一间工具间,里面的家伙事更专业。今天的事情就是给他一把那间工具间的钥匙,同时把三件事说清楚:里面都有什么、怎么借、出了事算谁的。
MCP(Model Context Protocol)就是这把钥匙的标准形状。它规定了工具间怎么挂牌子、怎么递工具、怎么报错,于是按这个标准写的工具和客户端可以互相认得。今天我们写客户端那一半。
这里必须先回答一个问题:为什么不用官方 SDK。理由和前十四天一样——这门课的卖点就是你能自己写出来。但今天还有一个额外理由:协议这一层的坑,用了 SDK 你一个都碰不到,而它们恰恰是线上出事的地方。 半行报文、分页没翻完、把通知当成响应、把别人的自我声明当成权限——这四件事 SDK 都替你挡了,于是你也永远不知道它们存在。
面试题库
不用官方 SDK 手写一个 MCP 客户端,你必须自己处理哪些协议细节?If you hand-write an MCP client without the official SDK, which protocol details do you have to handle yourself?
国内高频海外高频基础#json-rpc#mcp-client🔒 解锁本章后查看答题要点。
stdio 与 Streamable HTTP 两种传输分别适合什么场景?它们的失败方式有什么不同?When would you use the stdio transport versus Streamable HTTP, and how do their failure modes differ?
国内高频海外高频进阶#transports#stdio-vs-http🔒 解锁本章后查看答题要点。
把第三方 MCP server 的工具聚合进自己的 Agent,你会加哪些治理措施?What governance would you put in place before aggregating third-party MCP server tools into your own agent?
国内高频海外高频深入#trust-boundary#tool-governance🔒 解锁本章后查看答题要点。
