AI导哈

模型上下文协议学习指南

一个面向初学者的开源课程，提供多语言代码示例和实践项目，用于学习和实现模型上下文协议（MCP）。

  • by swapniljagtap061191
  • Jupyter Notebook
  • 本地部署
  • 更新于
在 GitHub 查看 swapniljagtap061191/Model-Context-Protocol-MCP

使用说明

按照以下步骤开始使用这些资源：

  1. 分叉存储库：单击
  2. 克隆存储库: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. 加入Azure AI Foundry Discord，与专家和其他开发人员会面

🌐 多语言支持

通过GitHub Action支持（自动且始终最新）

阿拉伯语 | 孟加拉语 | 保加利亚语 | 缅甸语（缅甸） | 中文（简体） | 中文（繁体，香港） | 中文（繁体，澳门） | 中文（繁体，台湾） | 克罗地亚语 | 捷克 | 丹麦语 | 荷兰的 | 爱沙尼亚语 | 芬兰语 | 法语 | 德语 | 希腊语 | 希伯来语 | 印地语 | 匈牙利语 | 印度尼西亚语 | 意大利语 | 日语 | 韩语 | 立陶宛语 | 马来语 | 马拉地语 | 尼泊尔语 | 挪威的 | 波斯语（波斯语） | 波兰语 | 葡萄牙语（巴西） | 葡萄牙语（葡萄牙） | 旁遮普语（Gurmukhi） | 罗马尼亚语 | 俄语 | 塞尔维亚语（西里尔文） | 斯洛伐克语 | 斯洛文尼亚语 | 西班牙语 | 斯瓦希里语 | 瑞典语 | 他加禄语（菲律宾语） | 泰米尔 | 泰语 | 土耳其语 | 乌克兰语 | 乌尔都语 | 越南语

🚀 面向初学者的模型上下文协议（MCP）课程

通过C#、Java、JavaScript、Rust、Python和TypeScript的实践代码示例学习MCP

🧠 模型上下文协议课程概述

这 模型上下文协议（MCP） 是一个尖端的框架，旨在标准化人工智能模型和客户端应用程序之间的交互。这个开源课程提供了一个结构化的学习路径，包括实用的编码示例和现实世界的用例，涵盖了包括C#、Java、JavaScript、TypeScript和Python在内的流行编程语言。

无论您是AI开发人员、系统架构师还是软件工程师，本指南都是您掌握MCP基础知识和实施策略的全面资源。

🔗 MCP官方资源

🧭 MCP课程概述

📚 完整的课程结构

模块 主题 描述 链接
模块1-3：基础
00 MCP简介 模型上下文协议概述及其在人工智能管道中的意义 阅读更多
01 核心概念详解 深入探讨MCP核心概念 阅读更多
02 MCP中的安全 安全威胁和最佳实践 阅读更多
03 MCP入门 环境设置、基本服务器/客户端、集成 阅读更多
模块3：构建您的第一个服务器和客户端
3.1 第一台服务器 创建您的第一台MCP服务器 指南
3.2 第一个客户端 开发一个基本的MCP客户端 指南
3.3 带LLM的客户端 集成大型语言模型 指南
3.4 VS代码集成 在VS代码中使用MCP服务器 指南
3.5 stdio服务器 使用stdio传输创建服务器 指南
3.6 HTTP流媒体 在MCP中实现HTTP流媒体 指南
3.7 AI工具包 将AI工具包与MCP结合使用 指南
3.8 测试 测试您的MCP服务器实现 指南
3.9 部署 将MCP服务器部署到生产环境 指南
3.10 高级服务器使用 使用高级服务器进行高级功能使用和改进架构 指南
3.11 简单身份验证 一章从头开始展示身份验证和RBAC 指南
模块4-5：实用与高级
04 实际实现 SDK、调试、测试、可重用提示模板 阅读更多
05 MCP高级主题 多模式AI、扩展、企业使用 阅读更多
5.1 Azure集成 MCP与Azure集成 指南
5.2 多模式 使用多种模式 指南
5.3 OAuth2演示 实现OAuth2身份验证 指南
5.4 根上下文 理解和实现根上下文 指南
5.5 路由 MCP路由策略 指南
5.6 采样 MCP中的采样技术 指南
5.7 缩放 缩放MCP实施 指南
5.8 安全 高级安全考虑 指南
5.9 网络搜索 实现网络搜索功能 指南
5.10 实时流媒体 构建实时流媒体功能 指南
5.11 实时搜索 实现实时搜索 指南
5.12 Entra ID认证 使用Microsoft Entra ID进行身份验证 指南
5.13 Foundry集成 与Azure AI Foundry集成 指南
5.14 上下文工程 有效的上下文工程技术 指南
5.15 MCP自定义传输 自定义传输实现 指南
模块6-10：社区与最佳实践
06 社区贡献 如何为MCP生态系统做出贡献 指南
07 早期采用的见解 现实世界的实施故事 指南
08 MCP最佳实践 性能、容错性、弹性 指南
09 MCP案例研究 实际实施示例 指南
10 实践工作坊 使用AI工具包构建MCP服务器 实验室
模块11:MCP服务器实践实验室
11 MCP服务器数据库集成 PostgreSQL集成综合13个实验室实践学习路径 实验室
11.1 简介 MCP概述，包括数据库集成和零售分析用例 实验室00
11.2 核心架构 了解MCP服务器架构、数据库层和安全模式 实验室01
11.3 安全和多租户 行级安全、身份验证和多租户数据访问 实验室02
11.4 环境设置 设置开发环境、Docker、Azure资源 实验室03
11.5 数据库设计 PostgreSQL设置、零售模式设计和示例数据 实验室04
11.6 MCP服务器实现 构建具有数据库集成的FastMCP服务器 实验室05
11.7 工具开发 创建数据库查询工具和模式自检 实验室06
11.8 语义搜索 使用Azure OpenAI和pgvector实现向量嵌入 实验室07
11.9 测试与调试 测试策略、调试工具和验证方法 实验室08
11.10 VS代码集成 配置VS代码MCP集成和AI聊天使用 实验室09
11.11 部署策略 Docker部署、Azure容器应用程序和扩展考虑因素 实验室10
11.12 监控 应用程序洞察、日志记录、性能监控 实验室11
11.13 最佳实践 性能优化、安全强化和生产技巧 实验室12

💻 示例代码项目

基本MCP计算器示例

语言 描述 链接
C# MCP服务器示例 查看代码
Java MCP计算器 查看代码
JavaScript MCP演示 查看代码
Python MCP服务器 查看代码
TypeScript MCP示例 查看代码
锈蚀 MCP示例 查看代码

高级MCP实施

语言 描述 链接
C# 高级示例 查看代码
Java与Spring 容器应用程序示例 查看代码
JavaScript 高级示例 查看代码
Python 复杂实现 查看代码
TypeScript 容器示例 查看代码

🎯 学习MCP的先决条件

为了充分利用这门课程，你应该：

  • 具备以下至少一种语言的编程基础知识：C#、Java、JavaScript、Python或TypeScript

  • 了解客户端-服务器模型和API

  • 熟悉REST和HTTP概念

  • （可选）AI/ML概念背景

  • 加入我们的社区讨论以获得支持

📚 学习指南和资源

此存储库包括几个资源，可帮助您有效地导航和学习：

学习指南

全面 学习指南 可帮助您有效地浏览此存储库。该指南包括：

  • 显示所有主题的可视化课程地图
  • 每个存储库部分的详细细分
  • 关于如何使用示例项目的指导
  • 针对不同技能水平的推荐学习路径
  • 补充您学习旅程的额外资源

更新日志

我们保持详细 更新日志 跟踪课程材料的所有重要更新，包括：

  • 新增内容
  • 结构性变化
  • 功能改进
  • 文档更新

🛠️ 如何有效地使用本课程

本指南中的每一课都包括：

  1. MCP概念的清晰解释
  2. 多种语言的实时代码示例
  3. 构建真实MCP应用程序的练习
  4. 为高级学习者提供额外资源

事件

MCP开发日2025年7月

➡️按需观看-MCP开发日

在MCP Dev days上准备两天的深入技术见解、社区联系和实践学习，这是一个专门针对模型上下文协议（MCP）的虚拟活动，MCP是连接人工智能模型和它们所依赖的工具的新兴标准。 您可以在我们的活动页面上注册观看MCP Dev Days：https://aka.ms/mcpdevdays.

第1天：MCP生产力、DevTools和社区：

这一切都是为了让开发人员在他们的开发工作流程中使用MCP，并庆祝MCP社区的出色表现。我们将与Arcade、Block、Okta和Neon等社区成员和合作伙伴一起，了解他们如何与微软合作，打造一个开放、可扩展的MCP生态系统。跨VS Code、Visual Studio、GitHub Copilot和流行社区工具的真实演示 实用的、上下文驱动的开发工作流程 社区主导的会议和见解 无论你是刚开始使用MCP还是已经开始使用它，第一天都会为你带来灵感和可操作的收获。

第2天：自信地构建MCP服务器

适用于MCP建设者。我们将深入探讨创建MCP服务器并将MCP集成到您的AI工作流程中的实施策略和最佳实践。

主题包括：

  • 构建MCP服务器并将其集成到代理体验中
  • 快速驱动开发
  • 安全最佳实践
  • 使用功能、ACA和API管理等构建块
  • 注册表对齐和工具（1P+3P）

如果你是一名开发人员、工具构建者或人工智能产品策略师，这一天充满了构建可扩展、安全和面向未来的MCP解决方案所需的见解。

MCP训练营2025年8月

在密集的视频课程中学习如何创建MCP服务器，如何与VS Code集成，以及如何根据MCP初学者课程的内容在Azure上进行专业部署。掌握大公司已经在使用的技术的实用技能。

➡️按需观看MCP训练营|英语

➡️按需观看MCP训练营|巴西

➡️按需观看MCP训练营|西班牙语

让我们用C#学习MCP-教程系列

让我们了解一下模型上下文协议（MCP），这是一个旨在标准化人工智能模型和客户端应用程序之间交互的前沿框架。通过这个初学者友好的课程，我们将向您介绍MCP，并指导您创建第一个MCP服务器。

C https://aka.ms/letslearnmcp-csharp

Java https://aka.ms/letslearnmcp-java

JavaScript： https://aka.ms/letslearnmcp-javascript

python https://aka.ms/letslearnmcp-python

🌟 社区感谢

感谢微软珍视的专业人士 希瓦姆·戈亚尔 用于贡献重要的代码示例。

📜 许可证信息

此内容根据 MIT许可证。有关条款和条件，请参阅 许可证.

🤝 贡献指南

该项目欢迎各方提供意见和建议。大多数捐款要求您同意 贡献者许可协议（CLA）声明您有权并实际授予我们 使用您贡献的权利。有关详细信息，请访问 https://cla.opensource.microsoft.com.

当您提交拉取请求时，CLA机器人将自动确定您是否需要提供 CLA并适当地装饰PR（例如，状态检查、评论）。只需按照说明进行操作 由机器人提供。您只需使用我们的CLA在所有存储库中执行一次此操作。

该项目采用了 微软开源行为准则. 有关更多信息，请参阅 行为准则常见问题 或 联系 opencode@microsoft.com 如有任何其他问题或意见。

📂 存储库结构

存储库组织如下：

  • 核心课程（00-11）：主要内容分为11个连续模块，包括综合数据库集成实验室
  • 11 MCPServerHandsOnLabs/：完成13个实验室学习路径，用于构建具有PostgreSQL集成的生产就绪MCP服务器
  • 图片/：整个课程中使用的图表和插图
  • 翻译/：自动翻译的多语言支持
  • 翻译图片/：图表和插图的本地化版本
  • study_guide.md：导航存储库的综合指南
  • changelog.md：记录课程材料的所有重大变化
  • mcp.json：MCP规范的配置文件
  • 代码_OF_CONDUCT.md、许可、安全.md、支持.md：项目治理文件

🎒 其他课程

我们的团队制作其他课程！查看：

™️ 商标通知

此项目可能包含项目、产品或服务的商标或徽标。授权使用Microsoft 商标或徽标必须遵守 微软商标和品牌指南. 在本项目的修改版本中使用Microsoft商标或徽标不得造成混淆或暗示Microsoft赞助。 任何使用第三方商标或徽标的行为均受这些第三方政策的约束。

获取帮助

如果你在构建AI应用程序时遇到困难或有任何疑问，请加入：

如果您在构建过程中有产品反馈或错误，请访问：

相关 MCP