开始之前

本机有 Node.js 20+,能读 JSON 与进程输出;不需要预先了解 MCP 协议,第一篇从角色和调用路径讲起。

这个主题要掌握什么

  • 一次请求经过 host、client、server:先分清谁负责路由、谁负责权限。
  • 接 server 前确认四道边界:进程权限、返回数据、凭据作用域、传输通道。
  • 工具名、描述与输入输出 schema 是契约;业务错误用结构化结果返回。
  • stdio server 不要把日志写到 stdout;用 Inspector 分层验证 tools/list 与 tools/call。
MCP 入门
MCP 架构概念:Host、Client、Server 与一次工具调用

用一次 count_words 调用串起 MCP 的 host、client、server、三类原语与 stdio/远程传输,建立排错前的概念地图。

MCP 进阶
MCP 安全边界:接一个 server 前要确认的四类权限

MCP 把外部能力接进 Agent,也把外部风险接进来。逐个划清四道边界:进程权限、返回数据、凭据作用域、传输通道,并给出可落地的收紧配置。

MCP 入门
写第一个 MCP Server:stdio 工具、Inspector 验证与注册

用当前官方 SDK 写一个只做一件事的 MCP server,用 Inspector 验证协议层,再分别注册到 Claude Code 和 Codex,最后确认工具真的被调用而不是只在列表里出现。

MCP 进阶
MCP 工具设计:把 count_words 的契约写窄

以现有 count_words 为例,设计窄名称、输入输出 schema、校验与授权边界,并把业务失败变成稳定的结构化结果。

MCP 进阶
MCP 协议排错:从进程启动到 tools/call 的四层定位

用 Inspector CLI 把 MCP 故障拆成进程、握手、tools/list、tools/call 四层,覆盖 stdout 污染、cwd、环境变量与 schema 问题。