#MCP 完整教程

欢迎来到 MCP（Model Context Protocol，模型上下文协议） 完整教程。本教程基于 MCP 官方文档 与规范 2026-07-28 整理，把 MCP 当作独立的 开放协议课 来讲：你将学会 Host / Client / Server 如何协作、三种原语如何暴露上下文，以及如何用官方 Python SDK 写出可被多个 Agent 复用的服务器。

官方常用比喻：MCP 是 AI 应用的 USB-C。同一套接口，可以把本地文件、HTTP API、GitHub、浏览器等外部系统接到 Claude Code、Cursor、VS Code、ChatGPT 等宿主上，而不必为每个产品各写一套插件。

本课讲协议本身。Cursor / Claude Code / Codex / OpenCode 里的 MCP 章节是 客户端接法，本教程会交叉引用，不重复那些产品专属菜单与排障细节。

---

#教程目录

#基础篇

1. MCP 简介 — 为什么需要 MCP、USB-C 隐喻、适合谁学
2. 架构与角色 — Host / Client / Server、本地 vs 远程、数据层与传输层
3. 三大原语 — Tools、Resources、Prompts 与 JSON-RPC 概念示例
4. 传输层 — Stdio、Streamable HTTP，以及仍可见的遗留 SSE

#开发篇

5. 安装与环境 — Node / Python、pip install mcp、Inspector
6. 快速上手 — 最小加法工具 + Inspector 调用
7. Python 服务器 — 官方 SDK：Tool + Resource + Prompt
8. 接入客户端 — Cursor、Claude Code、Codex、OpenCode 配置片段

#应用与安全

9. 官方与常用服务器 — filesystem、GitHub、Fetch / Playwright、市场
10. 安全实践 — 审批、沙箱、白名单、供应链
11. 实战案例 — 本地笔记、包装公开 API、同一服务器接两个客户端
12. 资源与延伸阅读 — 规范、SDK、本站 Agent 课程

---

#学习路径

建议顺序：先 Inspector，再接 IDE / CLI。Inspector 能直接列出 tools / resources / prompts，比在聊天里猜「模型有没有看到这个工具」更快。

---

#前置知识

• Python 3.10+ 基础（装饰器、类型注解、虚拟环境）
• 了解 JSON 与「请求 / 响应」；不必先会 JSON-RPC
• 至少一个会连 MCP 的 Host（Cursor、Claude Code、Codex 等均可）；没有 Host 也能用 Inspector 学完整协议
• Node.js 用于 Inspector 与多数 npx 参考服务器（Inspector 文档当前要求较新的 Node，见安装章）
• Windows 请使用 PowerShell；本教程命令同时给出 Unix / macOS 写法

不要求你会写 LLM 应用框架。MCP 不规定 模型怎么用上下文，只规定上下文如何标准化交换。

---

#与本站其他课程的关系

当前规范版本为 2026-07-28：协议核心是 无会话（stateless） 的，能力发现走 server/discover。Sampling 已弃用，本教程只作提示，不再当作现行能力来教。

怎么读： 先建立 Host / Client / Server 与三种原语的图像，再用 Inspector 跑通最小 Server，最后才把同一进程写进某个产品的配置文件。遇到「聊天里看不到工具」时，回到 Inspector，而不是先怀疑模型。

---

#下一步

• MCP 简介
• 架构与角色
• 安装与环境