MCP 核心宝典 | 2025 最新最全!经典MCP案例实操讲解!学AI大模型的朋友必读! 📅 发布时间:2026/8/27 17:41:48 👁 浏览次数: 干货来了2025最新版超级详细MCP说明手册内容有点长耐心看完必有收获第一部分模型上下文协议MCP什么是 MCP 就好像你只会说英语想从只会说法语、德语等外语的人那里获取信息你得学对应外语。但要是有个能理解所有语言的翻译问题就简单了MCP就像这个翻译让代理能通过单一接口与其他工具或能力交流。实际上大型语言模型LLMs虽知识丰富、推理能力强能完成复杂任务但知识局限在初始训练数据内。若需实时信息就得用外部工具而MCP就是让AI模型无缝交互的标准化接口和框架类似USB-C 为电子设备统一连接标准。为何要创造 MCP 在MCP出现前连接AI与外部数据和操作的方式要么是为每个工具硬编码逻辑要么是管理不够稳健的提示链。要么是用特定供应商的插件框架导致出现 M×N 集成难题例如若有M个AI应用和N个工具 / 数据源可能需要 M×N 个定制集成。而MCP通过引入中间的标准接口解决此问题将 M×N 直接集成变为 MN 个实现。即每个 AI 应用实现一次 MCP 客户端每个工具实现一次 MCP 服务器简化了连接。MCP 架构概览**宿主Host******是面向用户的 AI 应用如聊天应用、AI 增强型 IDE 等。它发起与 MCP 服务器的连接捕获用户输入保留对话历史并显示模型回复。**客户端Client******在宿主内负责处理底层事务像适配器或信使负责按 MCP 协议执行宿主指令。服务器Server是提供功能工具等的外部程序或服务可本地或远程运行关键是以标准格式告知能做什么执行客户端请求并返回结果。MCP 基于客户端 - 服务器架构主要有三个角色**工具Tools******是AI可调用的可执行动作或函数通常由 AI 模型选择触发常涉及文件 I/O 或网络调用等副作用或需额外计算的操作。例如一个获取天气信息的简单工具AI 可通过调用该工具。传入地点参数服务器执行后返回结果客户端获取并供 AI 使用。**资源Resources******为 AI 提供只读数据类似数据库或知识库AI 可查询获取信息但不能修改。与工具不同资源通常在宿主控制下访问避免模型随意读取。示例从本地文件、知识库片段、数据库查询结果只读等获取内容。**提示Prompts******是预定义的提示模板或对话流程可注入以引导 AI 行为。例如代码审查的提示模板服务器提供后宿主可调用并插入用户代码供模型生成回复前使用。上面这三者构成了MCP框架的核心能力。第二部分MCP 实操项目案例讲解100%完全本地MCP客户端MCP 客户端就是AI应用例如 Cursor中的一个组件用于与外部工具建立连接。下面我们讲解如何完全在本地构建一个MCP项目。构建本地MCP客户端技术栈涉及LlamaIndex构建MCP驱动的代理、Ollama本地部署Deepseek-R1、LightningAI 用于开发和托管。工作流程包括用户提交查询、代理连接 MCP 服务器发现工具、调用工具获取上下文并返回响应。案例1SQLite MCP服务器下面我们看看如何实现SQLite MCP服务器、设置 LLM、定义系统提示、定义代理、定义代理交互、初始化 MCP 客户端和代理以及运行代理等步骤。步骤1构建SQLite MCP服务器在本次演示中我们搭建了一个简单的SQLite 服务器用到下面两个工具● 添加数据● 获取数据步骤2设置大型语言模型LLM我们将通过 Ollama 本地部署 Deepseek-R1将其用作 MCP 驱动代理的 LLM。步骤3定义系统提示我们为代理设置了指导性指令使其在回应用户查询前能够使用工具。 可根据实际需求灵活调整此设置。步骤4定义代理我们定义了一个函数用于构建一个典型的 LlamaIndex 代理并为其提供合适的参数。传递给代理的工具是 MCP 工具这些工具会被 LlamaIndex 封装为原生工具从而能够被我们的函数代理轻松使用。步骤5定义代理交互 我们将用户消息传递给函数代理并附带一个共享的上下文以实现记忆功能同时流式处理工具调用并返回其回复。在这里我们管理所有的聊天历史记录和工具调用。步骤6初始化 MCP 客户端和代理启动 MCP 客户端加载其工具并将它们封装为 LlamaIndex 中函数调用代理可用的原生工具。然后将这些工具传递给代理并添加上下文管理器。步骤7运行代理最后我们开始与代理进行交互并获取SQLite MCP服务器中的工具。以上就是我们完全本地化SQLite MCP演示部分大家感兴趣可以自行尝试MCP 驱动的代理式 RAG**案例2**MCP 驱动的代理式 RAG实现够搜索向量数据库下面我们讲解如何创建一个MCP 驱动的代理式 RAG实现够搜索向量数据库并在需要时回退到网络搜索技术栈使用 Bright Data 进行大规模网页抓取。采用 Qdrant 作为向量数据库。选择 Cursor 作为 MCP 客户端。流程用户通过 MCP 客户端Cursor输入查询。客户端联系 MCP 服务器以选择相关工具。工具输出返回给客户端以生成响应。现在我们来实现这个功能吧步骤1启动 MCP 服务器首先我们需要定义一个 MCP 服务器指定其主机 URL 和端口。**步骤2**向量数据库MCP工具通过 MCP 服务器暴露的工具需满足两项要求● 必须使用 “tool” 装饰器进行装饰。● 必须具备清晰的文档字符串。下面我们展示了一个用于查询向量数据库的 MCP 工具示例该数据库存储了与机器学习相关的常见问题。**步骤3**网络搜索MCP工具当查询与机器学习无关时我们使用 Bright Data 的 SERP API 进行网络搜索以从多个来源抓取数据并获取相关上下文。以下是实现网络搜索 MCP 工具的示例代码仅供参考fromfastmcpimportFastMcPimport requestsimport asyncio# 创建 MCP 服务器mcp FastMcP(web-search-demo)# 定义网络搜索工具mcp.tool()def bright_data_web_search_tool(query: str) - list[str]: 使用 Bright Data 的 SERP API 搜索了一些信息。输入 query(str)要搜索的信息。 输出 context(list[str])最相关的网络搜索结果列表。 # 获取环境变量中的 Bright Data 凭证 username os.getenv(BRIGHT_DATA_USERNAME) password os.getenv(BRIGHT_DATA_PASSWORD)# 设置代理 URL proxy_url fhttp://{username}:{password}brd.superproxy.io:33335# 格式化查询 formatted_query .join(query.split()) url fhttps://www.google.com/search?q{formatted_query}brd_json1num50# 发送请求 response requests.get(url, verifyFalse, proxies{http: proxy_url, https: proxy_url})# 返回结果 return response.json()[organic]**步骤4**将MCP服务器与 Cursor 集成转到设置 → MCP → 添加新的全局 MCP 服务器。在 JSON 文件中添加以下内容步骤5完成啦你的本地MCP服务器已成功上线并与 Cursor 完成了连接。目前该服务器提供了以下两个 MCP 工具● Bright Data 网络搜索工具可用于大规模抓取数据。● 向量数据库搜索工具可用于查询相关文档。接下来我们就可以与 MCP 服务器进行交互。● 当我们提出与机器学习ML相关的问题时它会调用向量数据库工具。● 但当我们提出一个泛化问题时它会调用 Bright Data 网络搜索工具从各个来源大规模地收集网络数据这就体现了代理的主动性最后为什么要学AI大模型当下⼈⼯智能市场迎来了爆发期并逐渐进⼊以⼈⼯通⽤智能AGI为主导的新时代。企业纷纷官宣“ AI ”战略为新兴技术⼈才创造丰富的就业机会⼈才缺⼝将达 400 万DeepSeek问世以来生成式AI和大模型技术爆发式增长让很多岗位重新成了炙手可热的新星岗位薪资远超很多后端岗位在程序员中稳居前列。与此同时AI与各行各业深度融合飞速发展成为炙手可热的新风口企业非常需要了解AI、懂AI、会用AI的员工纷纷开出高薪招聘AI大模型相关岗位。最近很多程序员朋友都已经学习或者准备学习 AI 大模型后台也经常会有小伙伴咨询学习路线和学习资料我特别拜托北京清华大学学士和美国加州理工学院博士学位的鲁为民老师给大家这里给大家准备了一份涵盖了AI大模型入门学习思维导图、精品AI大模型学习书籍手册、视频教程、实战学习等录播视频全系列的学习资料这些学习资料不仅深入浅出而且非常实用让大家系统而高效地掌握AI大模型的各个知识点。这份完整版的大模型 AI 学习资料已经上传CSDN朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】AI大模型系统学习路线在面对AI大模型开发领域的复杂与深入精准学习显得尤为重要。一份系统的技术路线图不仅能够帮助开发者清晰地了解从入门到精通所需掌握的知识点还能提供一条高效、有序的学习路径。但知道是一回事做又是另一回事初学者最常遇到的问题主要是理论知识缺乏、资源和工具的限制、模型理解和调试的复杂性在这基础上找到高质量的学习资源不浪费时间、不走弯路又是重中之重。AI大模型入门到实战的视频教程项目包看视频学习是一种高效、直观、灵活且富有吸引力的学习方式可以更直观地展示过程能有效提升学习兴趣和理解力是现在获取知识的重要途径光学理论是没用的要学会跟着一起敲要动手实操才能将自己的所学运用到实际当中去这时候可以搞点实战案例来学习。海量AI大模型必读的经典书籍PDF阅读AI大模型经典书籍可以帮助读者提高技术水平开拓视野掌握核心技术提高解决问题的能力同时也可以借鉴他人的经验。对于想要深入学习AI大模型开发的读者来说阅读经典书籍是非常有必要的。600AI大模型报告实时更新这套包含640份报告的合集涵盖了AI大模型的理论研究、技术实现、行业应用等多个方面。无论您是科研人员、工程师还是对AI大模型感兴趣的爱好者这套报告合集都将为您提供宝贵的信息和启示。AI大模型面试真题答案解析我们学习AI大模型必然是想找到高薪的工作下面这些面试题都是总结当前最新、最热、最高频的面试题并且每道题都有详细的答案面试前刷完这套面试题资料小小offer不在话下这份完整版的大模型 AI 学习资料已经上传CSDN朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】