MCP 模型上下文协议：十二、自测、练习与源码入口

🇬🇧 English version: mcp-guide/07-next-steps.md ｜ 📦 GitHub: https://github.com/geekchow/mcp-explain
你在哪里： 六个阶段之后。这一篇是发射台，不是课程。

如果下面这些你能不翻书答上来，这个系列你就算读完了：

MCP 为什么把审批闸门放在宿主，而不是服务器或协议里？
initialize 时的能力协商，究竟买到了运行时特性探测买不到的什么？
某个服务器需要用户在操作中途从三个选项里挑一个。用哪个原语？而且在此之前必须发生过什么，它才是合法的？
什么时候该用 JSON-RPC 错误，什么时候该用 isError: true？在 TypeScript SDK 里，一个非法的枚举值会产生哪一种------为什么那才是对的选择？
你的服务器返回了 5000 行，模型被绕晕了。按帮助程度从大到小说出三个修法。
是什么阻止了签发给服务器 A 的令牌被重放到服务器 B？
stdio 服务器为什么绝不能往 stdout 写东西？违反了会表现出什么症状？
"当前值班排班表"该做成资源还是工具？为什么？

把示例跑起来。 见 examples/README.md------安装、连上 Claude Code，然后用 printf 直接手搓协议，直到那些报文不再神秘。
写一个 40 行的服务器，做你真正需要的事：把团队的操作手册做成资源、一个针对开发库的查询工具、一个把你反复重复的流程编码下来的提示。
故意给它写一段糟糕的描述，看着模型用错，然后改好那段文字。没有比这更快的工具设计教学法。
给一个会改动状态的工具加上征询，亲身体会"模型问了一下"和"服务器坚持要问"之间的差别。
把它迁到 Streamable HTTP 并加上 OAuth。 这是一个玩具服务器变成组织级服务器的分水岭，也是深入 05不再是理论的时刻。

当规范和现实打架时，按这个顺序读代码：

你想搞懂什么	去哪看
规范本身	`modelcontextprotocol.io` 上的规范------先读 lifecycle ，再读 tools ，然后 authorization；其余略读
一个服务器实际是怎么组装的	`@modelcontextprotocol/sdk`（TypeScript）------`server/mcp.ts` 看 `registerTool`/`registerResource`/`registerPrompt`，`server/stdio.ts` 和 `server/streamableHttp.ts` 看传输
客户端如何驱动一个会话	同一个 SDK 的 `client/index.ts`------请求表、超时、进度与取消都在这里
线上到底跑的是什么报文	MCP Inspector （`npx @modelcontextprotocol/inspector <你的服务器命令>`）
宿主侧的配置与权限	`claude mcp --help`、`claude mcp list`，以及你 `settings.json` 里的 `permissions` 块------再加上会话里的 `/mcp`
参考实现	`modelcontextprotocol/servers` 仓库------先读小的；filesystem 服务器是工具粒度的好范本

规范的 Authorization 那一页。 很短，而且是绝大多数实现做错的那部分。
规范的 Security best practices 那一页。 混淆代理、令牌透传、会话劫持------深入 05点名过的攻击，在这里有规范性的表述。
Claude Code 的 MCP 文档。 作用域、.mcp.json、--mcp-config、--strict-mcp-config、MAX_MCP_OUTPUT_TOKENS、插件打包的服务器。
LSP（Language Server Protocol，语言服务器协议）规范。 MCP 的前辈。两份规范并排读，会让 MCP 的选择显得必然，而不是任意。
随便挑两个参考服务器做 diff。 工具粒度是一种靠比较养成的品味，不是靠规则。

好让你知道自己还不知道什么：

本文是一个开源指南系列的一部分。整个系列、全部图表源码，以及一个可以直接让 Claude Code 连上去的可运行 MCP 服务器，都在同一个仓库里：


本页源文件	`mcp-guide-zh/07-next-steps.md`
英文原版	`mcp-guide/07-next-steps.md`
可运行示例服务器	`mcp-guide/examples/orders-db-server`
系列起点	`mcp-guide-zh/00-overview.md`

欢迎指正------如果某个协议细节随新版本发生了变化，欢迎提 issue。