Skip to content
学习笔记 · Lv4 AI 应用框架

MCP 协议

给 Agent 接上外部工具的标准接口。

支线6 章

开始学习 → 从「第 1 章:为什么需要一层协议」读起← 回到书架

MCP 协议 ​

工具的 USB-C。写一次 server,所有支持 MCP 的应用插上就能用;实现一次 client,就能接所有 server。


🗺️ 学习路线图 ​

阶段章节你要解决的事
🧠 看懂第 1–2 章为什么需要协议、JSON-RPC 与握手长什么样
🧰 会写第 3–5 章三原语怎么选、两种传输怎么挑、server 怎么写
🛡️ 敢上线第 6 章接进 Agent、鉴权、四类风险与清单

📚 章节导航 ​

章节难度 · 阅读一句话概要
1 · 为什么需要一层协议⭐ 15 minN×M 压成 N+M,与 Function Calling 的分工
2 · 协议骨架⭐⭐ 20 minJSON-RPC 三态、initialize 握手、能力协商
3 · 三个原语⭐⭐ 18 minTools / Resources / Prompts 与"谁决定"
4 · 两种传输⭐⭐ 15 minstdio 与 Streamable HTTP,怎么选与怎么调
5 · 写一个 Server⭐⭐⭐ 22 min查库存、开工单、读配置、给话术
6 · 接进 Agent 并上线⭐⭐⭐ 22 min四步接入、OAuth、四类风险、十项清单

🎯 适合人群 ​

人群推荐起点阅读建议
只想用别人做好的 server第 4 章会配 stdio 启动命令就够
要把内部系统接给 AI第 3、5 章先想清"动作还是数据",再写代码
在做 Agent 产品第 2、6 章握手与安全边界是产品底线
被"工具太多个模型选不准"困扰第 6 章6.3 的动态筛选最实用

📂 目录结构 ​

docs/notes/mcp/                      # 课程正文(线上路径 /notes/mcp/)
├── README.md                        # 本页:学习路线与章节导航
└── chapters/                        # 6 个章节
    ├── 01-why-mcp.md
    ├── 02-protocol.md
    ├── 03-primitives.md
    ├── 04-transport.md
    ├── 05-build-server.md
    └── 06-agent-security.md

🧭 怎么读这门课 ​

  • 只想尽快跑起来:4 → 5,半小时能有一个能被审核的 server;
  • 要写进产品:2 → 3 → 6,协议细节与安全是必读;
  • 做技术评审:第 6 章的清单可以直接当验收标准;
  • 不打算自建:读完 1、4 就够用了。

示例沿用"小书店":查库存、开工单、读政策、售后话术,和前面几门课是同一套业务。


🔗 和其他课的衔接 ​

关系课程怎么接
前置结构化输出与 Function Calling第 1 章讲了两者的分工,那边是模型侧的实现
前置RAG 系统从零搭建RAG 服务做完,可以用 MCP 把它包成工具给 Agent 用
呼应LangChain 入门到 RAG第 5 章 Tools 是框架视角的工具定义,本课讲协议层
呼应AI Agent 前端开发Mastra 第 3 章的 MCP 小节是 JS 视角的同一件事
后续Lv5 全栈产品化把工具网关、审计、权限做成产品的一部分
本文阅读--次|全站访问--次|访客--人