Lesson 05 · s19 MCP
MCP 本身很小:外部服务用统一格式回答两个问题。有意思的是同一个钉钉 MCP, 在 Claude Code 里和在你分身里,接法完全相反——而且两边都对。
| 它规定的 | 服务端要答什么 | 对应第 1 课的哪一步 |
|---|---|---|
tools/list | 「我有这些工具」——每个工具一份声明:名字、描述、参数 schema | 发说明书那一步,只是说明书从外面来 |
tools/call | 「你调的这个,结果是……」 | 你的代码执行那一步,只是执行发生在别的进程里 |
传输是 JSON-RPC,走子进程的 stdin/stdout 或者 HTTP。仅此而已。 它没有规定谁来选工具、谁能看到工具——那是接入方的事。这一课讲的就是这个空白怎么填。
s19 的 assemble_tool_pool():连上一个 server,把 tools/list 回来的声明直接并进模型的工具列表,
名字前面加 mcp__{server}__ 防撞名。之后对模型来说,它和 Bash 没区别——都是一份声明,它读描述、填表。
证据就在我这次会话的工具列表里,原样:
mcp__dingtalk-doc__get_document_content
mcp__dingtalk-doc__create_document
mcp__dingtalk-doc__delete_document
mcp__dingtalk-doc__add_permission
mcp__yunxiao__search_workitems
mcp__drawio__create_new_diagram
…
注意钉钉那几个:读、建、删、授权,全在里面。谁选?我选。在第 3 课的表里,这一格归「模型 + 文字」。
ADR-0044 三个「不」,原文:
群消息与模型都不能提交任意 server、tool name 或参数,也不能动态发现后直接调用。……模型和群消息都不参与选择优先级。
mcp_gateway.py 里是这么落的:
| s19 的做法 | 你的做法 |
|---|---|
运行时 connect_mcp,动态发现 | 启动时代码里注册,DINGTALK_ALLOWED_TOOLS = ("get_document_info", "get_document_content") |
| 发现的工具进模型工具池 | DeepSeek 的工具列表里没有任何 MCP 工具,只有 get_weather |
| 模型选调哪个 | 代码按链接 host 确定性路由:钉钉域名 → 固定调那两个读工具 |
| 读写都暴露,靠标注区分 | 写能力一律不开,「今后若需要必须重新设计和决策」 |
| 进程内 SDK | 受限 Python 3.11 子进程(主服务在 3.9,SDK 要 3.10+) |
所以在第 3 课的表里,你的 MCP 整个在「代码」格。模型连 MCP 存在都不知道。
它只知道「有人分享了一个链接,正文是这段」——正文是 LinkMaterialReader 拿回来塞进文字的。
同一个钉钉 MCP server:在 Claude Code 里,给我开了建、删、授权;在分身里,只开两个读。 差别不在协议,在谁坐在模型那个位置、出了事谁兜底:
MCP 是传输,不是权限。把一个 server 接进来,等于拿到它的全部工具;开多少给模型,是接入方的决定。 你的 ADR-0044 把这个决定写得很硬,硬得对。
两条直接推论:
wanghuo-dingtalk-prd-attachment-uploader 要写钉钉。分身的 MCP 网关不开写,这是 ADR-0044 的硬约束,不是保守——所以第 4 课说「上传留给人」。MCP 让外部服务用统一格式回答的两个问题是什么?
tools/list 和 tools/call。前者送回一批声明(第 1 课的说明书),后者替你执行。谁能看到这些声明、谁来选,协议不管。
在你的分身里,DeepSeek 能看到几个钉钉 MCP 的工具?
它的工具列表里只有 get_weather。钉钉读取由 McpGateway 在代码里按 host 路由,模型拿到的是读回来的正文,不是工具。ADR-0044:「模型和群消息都不参与选择」。
mcp__dingtalk-doc__get_document_content 这个前缀是为了什么?
两个 server 都有 search 怎么办?加 mcp__{server}__ 前缀,再把非法字符换成下划线(s19 的 normalize_mcp_name)。只读/破坏性是另一套标注,不靠名字。
读这一份: MCP 官方 · Introduction。 看完 tools 那一段就够。你会发现它讲的东西比这一课少——因为协议本身就只有那么多,剩下的全是接入方的选择。