逐日AI微信小程序
7 天 MCP:把工具接进任何 Agent
第 1 周 · D5🔒 锁定约 6 小时

写一个 MCP client:在自己的 Agent 循环里发现并调用工具、多 server 聚合与命名冲突

反过来站到客户端一侧:手写一个能发现工具、把工具翻译成模型能看懂的形状、再把结果喂回循环的客户端,并处理多服务端聚合时的重名与失效。

今日目标 0/3

登录后可以勾选并保存进度。

今日目标

  1. 能手写一个 stdio 客户端,完成发现、调用、错误处理三步
  2. 能把 MCP 的工具定义翻译成模型 API 的工具参数,并说明两边名字不一样的地方
  3. 能给多服务端聚合设计一套命名前缀与降级策略,避免一个服务端挂掉拖垮整个循环

前四天你一直在写服务端:注册工具、暴露资源、搬到公网、加上授权。今天换到桌子的另一边。这个顺序是有意的——只有先把服务端能回的花样都实现过一遍,才知道客户端要接住多少种情况。读完回来把上面三条勾掉。

小白版讲解

客户端到底做什么

先破一个误解:很多人以为 MCP 客户端就是个转发器,把模型说的话原样递给服务端,再把服务端的话原样递回来。真写一遍就会发现,转发那部分只有几十行,剩下的全是边界。

回到万能插座那个比喻。服务端是电器,协议是插头标准,客户端是你家墙上那块带保护的插座面板:它认插头、它限流、它在某个电器冒烟的时候只跳自己那一路的闸,而不是让整栋楼停电。

具体是三条边界。

第一条是形状的边界。 MCP 的工具定义和模型 API 的工具参数不是同一个东西。字段名不一样,命名规则不一样,能表达的信息也不一样。中间必须有一次翻译,而翻译一定是有损的——损在哪,你得心里有数。

第二条是命名的边界。 一个宿主同时连着五个服务端很正常,规范只保证工具名在单个服务端内唯一。两个服务端各有一个 search,撞名是必然事件,不是意外。谁来消歧?只能是客户端。

第三条是失败的边界。 服务端跑在别人的进程里、别人的机器上。它会超时、会崩、会被用户手滑删掉。这些失败必须被挡在 Agent 循环之外——一个服务端挂掉,最坏的后果应该是少几个工具,而不是这一轮对话失败。

这三条边界,恰好就是今天要写的三段代码。

登录并关联后阅读全文

请先登录网页,并在账户页关联微信小程序账号。关联后每天可免费阅读 1 篇;额外文章需在小程序看广告解锁。

小程序码

微信扫码打开「逐日AI」,进入相同课程和章节,选择看广告解锁,完成后刷新本页。

面试题库

  • 你的客户端同时连了五个 MCP 服务端,其中两个都有一个叫 search 的工具。合并成一张工具表给模型时,重名该怎么处理?为什么不能直接拿服务端名做前缀?Your client is connected to five MCP servers and two of them expose a tool called search. How do you merge them into one tool list for the model, and why can't you just prefix with the server's name?
    国内高频海外高频进阶#client#tool-naming

    🔒 解锁本章后查看答题要点。

  • 线上一个 MCP 服务端超时了。你的 Agent 循环应该怎么反应?One of your MCP servers times out in production. How should your agent loop react?
    国内高频海外高频进阶#client#reliability

    🔒 解锁本章后查看答题要点。

  • 把 MCP 的工具定义翻译成模型 API 的工具参数时,最容易丢掉的是什么?丢了会怎样?When translating an MCP tool definition into a model API's tool parameters, what is most easily lost, and what goes wrong when it is?
    国内高频海外高频深入#client#tool-schema

    🔒 解锁本章后查看答题要点。

评论