使用说明
模型上下文协议书
为想要了解、构建和部署MCP服务器和客户端的开发人员提供全面的指南。
MCP是将AI应用程序连接到所需工具和数据的开放标准。这本书将你从“什么是MCP？”带到“我在生产环境中运行MCP服务器。”
这本书是写给谁的
- 后端开发人员 构建AI代理应该能够使用的工具和API
- AI/ML工程师 创建需要与外部系统交互的应用程序
- 全栈开发人员 将MCP集成到现有产品中
- 技术负责人 为其组织评估MCP
- 任何好奇的人 克劳德看天气时香肠是怎么做的
无需事先了解MCP知识。熟悉JSON、API和至少一种编程语言（首选TypeScript或Python）将有所帮助。
目录
第一部分：了解MCP
| 章节 | 标题 | 你将学到什么 |
|---|---|---|
| 01 | MCP解决的问题 | 为什么MCP存在，N次-M集成噩梦，以及MCP的“USB-C时刻” |
| 02 | 建筑 | 主机、客户端、服务器、信任边界、能力协商和三层蛋糕 |
| 03 | 有线协议 | JSON-RPC 2.0、消息类型、方法目录、初始化握手、错误代码、分页、取消 |
第二部分：三个原始人
| 章节 | 标题 | 你将学到什么 |
|---|---|---|
| 04 | 工具 | 工具定义、模式、注释、发现、调用、结果类型、错误处理、最佳实践 |
| 05 | 资源 | URI、资源模板、订阅、二进制数据、受众注释、资源与工具 |
| 06 | 提示 | 提示模板、参数、多消息提示、嵌入式资源、实用模式 |
第三部分：交通与通讯
| 章节 | 标题 | 你将学到什么 |
|---|---|---|
| 07 | 运输 | stdio、流式HTTP、传统SSE、代理模式、传输安全、调试传输 |
第四部分：建筑
| 章节 | 标题 | 你将学到什么 |
|---|---|---|
| 08 | 用TypeScript构建服务器 | McpServer API，Zod模式，天气服务器示例，HTTP传输，发布到npm |
| 09 | 用Python构建服务器 | FastMCP、装饰器、类型提示、SQLite资源管理器示例、uvx、发布到PyPI |
| 10 | 建设客户 | TypeScript和Python客户端，构建主机，管理多个服务器，完整的代理循环 |
第五部分：生态系统
| 章节 | 标题 | 你将学到什么 |
|---|---|---|
| 11 | SDK环境 | 所有10个官方SDK（TypeScript、Python、Go、C#、Java、Kotlin、Swift、Rust、Ruby、PHP），选择一个SDK |
| 12 | 配置 | 在Claude Desktop、Claude Code、VS Code、Cursor和Windsurf中设置MCP |
第六部分：安全和高级主题
| 章节 | 标题 | 你将学到什么 |
|---|---|---|
| 13 | 身份验证和安全 | OAuth 2.1、信任边界、威胁建模、服务器和主机的安全最佳实践 |
| 14 | 高级功能 | 采样、引出、根、完成、记录、进度报告 |
第七部分：生产及以后
| 章节 | 标题 | 你将学到什么 |
|---|---|---|
| 15 | 测试和调试 | MCP检查器、手动测试、常见问题、测试策略、调试技巧 |
| 16 | 生产模式 | 部署模型、Docker/K8s、无服务器、网关、多租户、监控、扩展 |
| 17 | 生态系统 | 官方服务器、社区服务器、注册表、发现、评估和构建生态系统 |
| 18 | MCP的未来 | 无状态协议、服务器卡、传输演进、代理融合、未来之路 |
如何阅读这本书
线性路径：阅读第1-18章，了解从概念到生产的完整过程。
快速开始：阅读第1-2章的概念，然后跳到第8章（TypeScript）或第9章（Python）开始构建。
参考：每一章都是独立的。跳到你需要的任何话题。
建筑深度挖掘第2、3、7和13章详细介绍了该协议。
实用指南：第8、9、10、12和15章是代码和配置的实践。
关于协议
模型上下文协议由创建 Anthropic 并于2024年11月作为开放标准发布。规范保持在 模型上下文协议.io 源代码位于 github/modelcontextprotocol.
在撰写本文时，当前的规范修订为 2025-11-25.
贡献
发现错误？有什么建议吗？打开问题或拉取请求。
许可证
这本书在指定的许可证下可用 许可证 文件。
