MCP开发从入门到实战

在当今人工智能（Artificial Intelligence，AI）快速发展的时代，AI 应用开发成为了科技领域的热门话题。模型上下文协议（Model Context Protocol，MCP）作为一项前沿技术，为开发者在构建和管理基于大语言模型的应用程序方面提供了强大的助力，能够有效提升开发效率和应用性能，成为推动AI 应用进一步拓展的关键因素。 本书旨在为读者提供一份关于MCP 的实用指南，帮助读者顺利打通从MCP 基础知识到高级应用的完整学习路径。本书共8章。第1章介绍MCP的定义、核心特点、技术架构、发展历程及应用场景。第2章介绍MCP 的核心架构、资源、提示词、工具、采样和根目录等基础概念。第3章介绍MCP SDK 的发展历程、核心价值、多语言生态及快速入门的方法。第4章介绍如何围绕Claude 桌面应用配置MCP 服务器，包括基础配置、服务器配置实例和常见问题排查。第5章介绍MCP 服务器开发，并以天气预报服务器为例讲解开发流程。第6章深入探讨MCP Inspector工具的使用方法、核心功能及最佳实践。第7章介绍MCP生态系统，包括宿主应用、领域应用、开发者工具与服务及广场。第8章分享了MCP在高效软件开发和创意内容生成方面的应用实践。 本书适合软件开发和人工智能领域的工程师和产品经理参考学习，也适合对AI应用开发感兴趣的技术爱好者、高校师生参考学习。

杨威理是一位深耕人工智能领域的技术极客与内容创作者。作为前Nokia 高级软件工程师，他凭借自身技术优势在AI 技术爆发初期成功转型为自媒体人，致力于AI 技术的普及与应用。 自ChatGPT 问世以来，杨威理专注于将复杂的AI 技术转化为通俗易懂的内容，推动AI技术在更广泛领域的应用与发展。他不仅是B 站频道“五里墩茶社”的 UP 主，还是自媒体账号“01 麻瓜社”的主理人。他通过视频和文字两种形式分享了大量AI 相关的内容，先后推出了“LangChain 极简入门”和“MCP 极简入门”等系列课程，帮助更多的人理解和掌握AI技术。 此外，杨威理开发了开源项目chat-ollama（一款基于LangChain的AI 聊天应用）。该应用支持主流的开源与闭源大模型，并整合了知识库功能，为用户提供了更加智能、便捷的AI交互体验。

第 1章　　认识MCP 1.1　MCP简介 2 1.1.1　什么是 MCP 2 1.1.2　核心特点与优势 3 1.1.3　技术架构概览 5 1.2　MCP的发展历程 5 1.2.1　项目背景与起源 6 1.2.2　技术演进路线 6 1.2.3　重要里程碑 7 1.3　MCP 的应用场景 8 1.3.1　企业应用场景：数字化转型 9 1.3.2　开发者场景 9 1.4　本章小结 11 第 2章　　MCP的基础概念 2.1　MCP核心架构 14 2.1.1　核心组件 14 2.1.2　连接的生命周期 18 2.1.3　错误处理 22 2.2　资源 23 2.2.1　资源概述 23 2.2.2　资源的URI 24 2.2.3　资源类型 25 2.2.4　发现资源 26 2.2.5　读取资源 29 2.2.6　更新资源 30 2.2.7　实现一个支持资源数据的MCP服务器 31 2.2.8　安全性如何保障 32 2.3　提示词 33 2.3.1　提示词概述 33 2.3.2　提示词结构 34 2.3.3　发现提示词 35 2.3.4　获取提示词 36 2.3.5　提示词消息类型 36 2.4　工具 38 2.4.1　工具概述 38 2.4.2　如何定义工具 39 2.4.3　工具消息类型 40 2.4.4　工具如何发现和更新 41 2.4.5　错误处理 42 2.5　采样 43 2.5.1　采样的工作原理 43 2.5.2　消息格式 45 2.5.3　安全性如何保障 46 2.5.4　错误处理 47 2.6　根目录 47 2.6.1　根目录的本质 47 2.6.2　为什么要使用根目录 48 2.6.3　根目录的工作机制 48 2.6.4　根目录的消息类型 48 2.6.5　常见用例 49 2.6.6　安全性如何保障 51 2.6.7　最佳实践 52 2.7　本章小结 52 第3章　　MCP SDK 3.1　SDK 的发展历程 54 3.2　SDK 的核心价值 54 3.3　MCP 的多语言 SDK 生态 54 3.4　SDK 快速入门 55 3.4.1　环境准备与安装 55 3.4.2　Python MCP服务器示例 57 3.5　本章小结 60 第4章　　基于Claude 桌面应用配置MCP服务器 4.1　基础配置 62 4.1.1　环境准备 62 4.1.2　初始化配置 63 4.2　MCP 服务器配置实例 66 4.2.1　文件系统服务器 66 4.2.2　Fetch 服务器 71 4.3　Claude MCP 常见问题排查 74 4.3.1　Claude 日志文件 75 4.3.2　MCP 问题排查示例 75 4.4　本章小结 77 第5章　　MCP 服务器开发指南 5.1　MCP 服务器开发基础 80 模块与包的概念 80 5.2　开发一款天气预报MCP服务器 82 5.2.1　环境准备 83 5.2.2　服务器开发流程 83 5.2.3　服务器开发进阶 95 5.3　本章小结 101 第6章　　MCP Inspector工具的使用 6.1　Inspector 基础 104 6.1.1　功能概述 104 6.1.2　架构简介 104 6.1.3　安装配置 107 6.1.4　界面介绍 110 6.2　核心功能使用 113 6.2.1　服务器连接面板 113 6.2.2　调试工具 115 6.2.3　资源浏览 118 6.2.4　提示词测试 120 6.2.5　通知面板 122 6.3　最佳实践 123 6.3.1　开发工作流 123 6.3.2　解决常见问题 125 6.4　本章小结 126 第7 章　　MCP生态系统 7.1　MCP 宿主应用 128 7.1.1　聊天应用 128 7.1.2　编程工具 133 7.2　领域应用 141 7.2.1　数据库服务 141 7.2.2　网页内容获取 155 7.2.3　设计与创意工具 158 7.2.4　向量数据库 165 7.3　开发者工具与服务 170 7.3.1　GitHub MCP 服务器 170 7.3.2　Slack MCP 服务器 173 7.4　MCP广场 179 7.4.1　Smithery 179 7.4.2　MCP.so 181 7.4.3　Glama 181 7.5　本章小结 183 第8 章　　MCP应用实践 8.1　高效软件开发 186 8.2　创意内容生成 192 8.3　本章小结 199 后记 200