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

1. Fork 仓库：点击
2. 克隆仓库： git clone https://github.com/microsoft/mcp-for-beginners.git
3. 加入

🌐 多语言支持

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

阿拉伯语 | 孟加拉语 | 保加利亚语 | 缅甸语 (Myanmar) | 中文（简体） | 中文（繁体，香港） | 中文（繁体，澳门） | 中文（繁体，台湾） | 克罗地亚语 | 捷克语 | 丹麦语 | 荷兰语 | 爱沙尼亚语 | 芬兰语 | 法语 | 德语 | 希腊语 | 希伯来语 | 印地语 | 匈牙利语 | 印度尼西亚语 | 意大利语 | 日语 | 卡纳达语 | 高棉语 | 韩语 | 立陶宛语 | 马来语 | 马拉雅拉姆语 | 马拉地语 | 尼泊尔语 | 尼日利亚皮钦语 | 挪威语 | 波斯语（法尔西） | 波兰语 | 葡萄牙语（巴西） | 葡萄牙语（葡萄牙） | 旁遮普语（古鲁穆奇文） | 罗马尼亚语 | 俄语 | 塞尔维亚语（西里尔字母） | 斯洛伐克语 | 斯洛文尼亚语 | 西班牙语 | 斯瓦希里语 | 瑞典语 | 塔加洛语（菲律宾语） | 泰米尔语 | 泰卢固语 | 泰语 | 土耳其语 | 乌克兰语 | 乌尔都语 | 越南语

更喜欢本地克隆？

本仓库包含 50 多种语言翻译，显著增加了下载大小。若想克隆不带翻译的内容，请使用稀疏检出：

Bash / macOS / Linux：

git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'

CMD（Windows）：

git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"

这为您提供了完成课程所需的一切，同时下载速度更快。

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

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

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

欢迎踏上模型上下文协议的学习之旅！如果您曾好奇 AI 应用如何与不同的工具和服务通信，您即将发现这一优雅的解决方案，它正在改变开发者构建智能系统的方式。

可以将 MCP 视为 AI 应用的通用翻译器——就像 USB 端口允许您连接任何设备到电脑一样，MCP 允许 AI 模型以标准化的方式连接到任何工具或服务。无论您是在构建第一个聊天机器人，还是在处理复杂的 AI 工作流，理解 MCP 都将赋予您构建更强大、更灵活应用的能力。

本课程设计耐心细致，陪伴您的学习之旅。我们将从您已了解的简单概念开始，通过您喜欢的编程语言的实操练习逐步提升您的技能。每一步都包含清晰的说明、实用的示例和大量鼓励。

完成这一旅程时，您将有信心构建自己的 MCP 服务器，集成流行的 AI 平台，并了解这项技术如何重塑 AI 开发的未来。让我们一起开始这段激动人心的冒险吧！

官方文档与规范

当前协议版本是 MCP Specification 2026-07-28。MCP 规范采用基于日期的版本号（格式为 YYYY-MM-DD），以明确协议 之间的兼容性。

版本说明： 本课程教授当前的 2026-07-28 概念，包括无状态请求、扩展框架，以及 弃用 Roots、Sampling 和 Logging 功能。一些实操示例仍显式版本为 2025-11-25，以配合 SDK 的逐步支持。详情见 MCP 变化内容：2026-07-28 规范 及迁移指南。

随着您的理解加深，这些资源将更有价值，但无需立即全部阅读。请选择您最感兴趣的内容开始！

• 📘 MCP 文档 – 这是您的入门资源，提供循序渐进的教程和用户指南。文档面向初学者，提供清晰示例，您可以按自己的节奏学习。
• 📜 MCP 规范 – 可视为全面的参考手册。随着课程进展，您会多次回来看具体细节和探索高级功能。
• 📜 MCP 规范版本管理 – 提供协议版本历史信息及 MCP 如何使用基于日期的版本号（YYYY-MM-DD 格式）。
• 🧑‍💻 MCP GitHub 仓库 – 这里有多种编程语言的 SDK、工具和代码示例，像是实用示例和现成组件的宝藏库。
• 🌐 MCP 社区 – 加入志同道合的学习者和经验丰富的开发者，共同讨论 MCP。这里是一个支持性的社区，欢迎提问和自由分享知识。

学习目标

完成本课程后，您将充满自信和热情，掌握以下能力：

• 理解 MCP 基础：您将掌握模型上下文协议的定义及其为何正在革命性地改变 AI 应用协同工作的方式，借助贴切的类比和示例帮助理解。

• 构建第一个 MCP 服务器：您将用喜欢的编程语言创建一个可运行的 MCP 服务器，从简单示例开始，逐步提升技能。

• 将 AI 模型连接到真实工具：您将学习如何搭建 AI 模型与实际服务之间的桥梁，赋予应用强大新能力。

• 实施安全最佳实践：您将了解如何保障 MCP 实现的安全，保护应用和用户。

• 自信部署：您将掌握将 MCP 项目从开发推向生产的实用部署策略，适用于实际环境。

• 加入 MCP 社区：您将成为不断壮大的开发者社区一员，共同塑造 AI 应用开发的未来。

基础背景知识

在深入 MCP 细节前，确保您对一些基础概念感到舒适。如果您对这些领域不是专家也无妨——我们会逐步解释您需要了解的一切！

理解协议（基础）

可以把协议想象成对话的规则。当您拨打电话给朋友时，双方都知道接听时要说“你好”，轮流讲话，结束时说“再见”。计算机程序也需要类似规则来有效沟通。

MCP 是一种协议——一套公认的规则，帮助 AI 模型与工具和服务进行有效“对话”。就像对话规则让人类交流更流畅，MCP 也让 AI 应用通信更可靠更强大。

客户端-服务器关系（程序协作方式）

您每天都在使用客户端-服务器关系！当您用浏览器（客户端）访问网站时，您连接的是发送页面内容的网络服务器。浏览器知道如何请求信息，服务器知道如何响应。

在 MCP 中，我们有类似的关系：AI 模型作为客户端请求信息或操作，MCP 服务器提供这些能力。就像 AI 有一个助理（服务器），可以帮它执行特定任务。

标准化为何重要（让事物协同工作）

想象如果每个汽车制造商都用不同形状的加油枪——您需要为每辆车准备不同的适配器！标准化意味着达成共识，共用通用方法，使事物无缝协作。

MCP 为 AI 应用提供了这种标准化。不是每个 AI 模型都需要为每个工具写定制代码，MCP 创造了一种通用通信方式。这样，开发者只需构建一次工具，就能与多种 AI 系统兼容。

🧭 您的学习路径概览

您的 MCP 之旅经过精心设计，逐步增强您的自信和技能。每个阶段介绍新概念，同时巩固已学内容。

🌱 基础阶段：理解基础知识（模块 0-2）

你的冒险从这里开始！我们将通过熟悉的类比和简单的示例向你介绍MCP的概念。你将了解什么是MCP，为什么它存在，以及它如何融入更广泛的人工智能开发领域。

• 模块 0 - MCP 介绍：我们将从探索 MCP 是什么以及为什么它对现代 AI 应用如此重要开始。你将看到 MCP 实际应用的真实案例，并理解它如何解决开发者面临的常见问题。

• 模块 1 - 核心概念解析：这里你将学习 MCP 的基本构建块。我们将使用大量类比和直观示例，确保这些概念变得自然且易于理解。

• 模块 2 - MCP 安全性：安全听起来可能令人生畏，但我们将展示 MCP 内置的安全功能，并教授保护你的应用程序从一开始就安全的最佳实践。

🔨 构建阶段：创建你的第一个实现（模块 3）

现在真正的乐趣开始了！你将获得构建 MCP 服务器和客户端的实战经验。别担心——我们将从简单开始，并引导你完成每一步。

本模块包含多个动手指南，让你用自己偏好的编程语言进行练习。你将创建你的第一个服务器，构建连接它的客户端，甚至集成流行的开发工具如 VS Code。

每个指南都包括完整的代码示例、故障排除技巧以及我们作出特定设计选择的原因说明。通过这一阶段，你将拥有值得骄傲的 MCP 实现！

🚀 成长阶段：高级概念与实际应用（模块 4-5）

掌握基础后，你准备探索更复杂的 MCP 特性。我们将涵盖实用的实现策略、调试技术以及多模态 AI 集成等高级话题。

你还将学习如何将 MCP 实现扩展到生产环境，并集成如 Azure 这样的云平台。这些模块将助你构建能够应对现实需求的 MCP 解决方案。

🌟 精通阶段：社区与专业方向（模块 6-11）

最后阶段侧重于加入 MCP 社区并专注于你最感兴趣的领域。你将学习如何为开源 MCP 项目做贡献，实施高级认证模式，以及构建全面集成数据库的解决方案。

模块 11 特别值得一提——它是一个完整的 13 实验动手学习路径，教授你构建带有 PostgreSQL 集成的生产级 MCP 服务器。它就像一个总结项目，将你所学的内容汇聚一堂！

📚 完整课程结构

模块	主题	描述	链接
模块 0-3：基础
00	MCP 介绍	模型上下文协议及其在 AI 流水线中的重要性概述	阅读更多
01	核心概念解析	深入探讨 MCP 核心概念	阅读更多
1.1	MCP 中的变化（2026-07-28）	无状态协议、扩展框架以及当前规范中的功能弃用	指南
02	MCP 安全性	安全威胁与最佳实践	阅读更多
2.1	CIMD 与 DCR 授权	使用受保护 MCP 服务器比较首选的 CIMD 注册与已弃用的 DCR 回退	示例
03	MCP 快速入门	环境搭建、基础服务器/客户端、集成	阅读更多
模块 3：构建你的第一个服务器和客户端
3.1	第一个服务器	创建你的第一个 MCP 服务器	指南
3.2	第一个客户端	开发基本 MCP 客户端	指南
3.3	搭载 LLM 的客户端	集成大型语言模型	指南
3.4	VS Code 集成	在 VS Code 中使用 MCP 服务器	指南
3.5	stdio 服务器	使用 stdio 传输创建服务器	指南
3.6	HTTP 流	在 MCP 中实现 HTTP 流功能	指南
3.7	Microsoft Foundry 工具包	使用 Microsoft Foundry 工具包与 MCP	指南
3.8	测试	测试你的 MCP 服务器实现	指南
3.9	部署	将 MCP 服务器部署到生产环境	指南
3.10	高级服务器使用	使用高级服务器实现高级功能并改进架构	指南
3.11	简单认证	从头学习认证与基于角色的访问控制（RBAC）	指南
3.12	MCP 主机	配置 Claude Desktop、Cursor、Cline 及其他 MCP 主机	指南
3.13	MCP 检查器	使用检查器工具调试和测试 MCP 服务器	指南
3.14	采样	利用采样与客户端协同工作	指南
3.15	MCP 应用	构建 MCP 应用	指南
模块 4-5：实用与高级
04	实用实现	SDK、调试、测试、可复用提示模板	阅读更多
4.1	分页	使用基于光标的分页处理大量结果集	指南
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 集成	与 Microsoft Foundry 集成	指南
5.14	上下文工程	高效上下文工程技术	指南
5.15	MCP 自定义传输	自定义传输实现	指南
5.16	协议特性	进度通知、取消、资源模板	指南
5.17	对抗式多代理推理	两个代理使用共享 MCP 工具对立辩论，由评审代理评分	指南
模块 6-10：社区与最佳实践
06	社区贡献	如何为 MCP 生态系统做贡献	指南
07	早期采用洞见	真实世界实现故事	指南
08	MCP 最佳实践	性能、容错、弹性	指南
09	MCP 案例研究	实际实现示例	指南
10	动手工作坊	使用 Microsoft Foundry 工具包构建 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 Code 集成	配置 VS Code MCP 集成及 AI 聊天使用	实验 09
11.11	部署策略	Docker 部署、Azure 容器应用及扩展考虑	实验 10
11.12	监控	应用洞察、日志记录、性能监控	实验 11
11.13	最佳实践	性能优化、安全加固及生产建议	实验 12
模块 12：MCP 工具
12.1	工具	MCP 在 Copilot 应用中的使用	指南

💻 示例代码项目

学习 MCP 最令人兴奋的部分之一是看到你的代码技能逐步发展。我们设计的代码示例从简单开始，随着你理解的加深逐渐变得更复杂。以下是我们介绍概念的方式——通过易于理解但展示真实 MCP 原则的代码，你不仅会明白这段代码做了什么，还会理解它为什么这样构造，以及它如何融入更大的 MCP 应用程序中。

基础 MCP 计算器示例

语言	说明	链接
C#	MCP 服务器示例	查看代码
Java	MCP 计算器	查看代码
JavaScript	MCP 演示	查看代码
Python	MCP 服务器	查看代码
TypeScript	MCP 示例	查看代码
Rust	MCP 示例	查看代码

高级 MCP 实现

语言	说明	链接
C#	高级示例	查看代码
使用 Spring 的 Java	容器应用示例	查看代码
JavaScript	高级示例	查看代码
Python	复杂实现	查看代码
TypeScript	容器示例	查看代码

🎯 学习 MCP 的先决条件

要最大化这份课程的收获，你应该具备：

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

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

• 熟悉 REST 和 HTTP 概念

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

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

📚 学习指南和资源

本仓库包括多个资源，帮助你高效导航和学习：

学习指南

提供了全面的 学习指南 以帮助你有效浏览此仓库。该可视化课程图展示了所有主题的连接方式，并提供如何有效使用示例项目的指导。如果你是视觉型学习者，喜欢看整体架构，这将特别有帮助。

指南内容包括：

• 展示所有涵盖主题的可视化课程图
• 各仓库部分的详细解析
• 关于如何使用示例项目的指导
• 针对不同技能水平的推荐学习路径
• 补充学习之旅的额外资源

更新日志

我们维护详细的 更新日志，跟踪课程材料的所有重大更新，助你及时掌握最新改进和新增内容。

• 新内容添加
• 结构调整
• 功能改进
• 文档更新

🛠️ 如何高效使用本课程

本指南中的每节课程包含：

1. 清晰的 MCP 概念讲解
2. 多语言实时代码示例
3. 构建真实 MCP 应用的练习
4. 面向高级学习者的额外资源

用 C# 学习 MCP - 教程系列

让我们一起学习 Model Context Protocol (MCP)，这是一个前沿框架，旨在标准化 AI 模型与客户端应用之间的交互。通过这段适合初学者的课程，我们将引导你了解 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

🎓 你的 MCP 之旅启程

恭喜！你刚迈出了激动人心的第一步，这将扩展你的编程能力，连接到 AI 开发的前沿。

你已取得的成就

通过阅读本介绍，你已开始建立 MCP 知识基础。你明白 MCP 是什么，为什么重要，以及本课程如何支持你的学习旅程。这是一个重要的成就，也是你掌握这一关键技术的起点。

前方的冒险

随着你完成各模块，记住每位专家都曾是初学者。现在看似复杂的概念，随着你的练习与应用，会变得轻而易举。每一个小步骤都将构建强大的能力，伴随你整个开发生涯。

你的支持网络

你正在加入一个由热衷 MCP 的学习者和专家组成的社区，他们渴望帮助他人成功。无论你在编码中遇到难题，还是乐于分享突破，社区都会支持你的旅程。

如果你遇到困难或对构建 AI 应用有任何疑问，加入学习者和经验丰富的开发者的 MCP 讨论。这是一个支持性社区，欢迎提问，知识自由共享。

如果你在构建中有产品反馈或遇到错误，请访问：

准备好开始了吗？

你的 MCP 冒险现在开始！从模块 0 开始，深入体验你的首次 MCP 实践，或浏览示例项目，看看你将构建什么。别忘了——每位专家都是从你现在的起点开始的，凭借耐心和练习，你会惊讶于自己的成就。

欢迎来到 Model Context Protocol 开发的世界。让我们一起构建精彩的东西！

🤝 贡献学习社区

这个课程因学习者像你一样的贡献而日益强化！无论是纠正拼写错误，建议更清晰的说明，还是添加新的示例，你的贡献都帮助其他初学者取得成功。

感谢微软资深专家 Shivam Goyal 贡献代码示例。

贡献流程设计得友好且支持性强。大部分贡献需要签署贡献者许可协议（CLA），但自动化工具会引导你顺利完成此流程。

📜 开源学习

整个课程以 MIT 许可证 授权发布，意味着你可以自由使用、修改和分享。这支持我们让 MCP 知识对全球开发者开放的使命。

🤝 贡献指南

本项目欢迎贡献和建议。大多数贡献需要你同意一份 贡献者许可协议（CLA），声明你有权并确实授予我们 使用你贡献的权利。详情见 https://cla.opensource.microsoft.com。

当你提交拉取请求时，CLA 机器人会自动判断你是否需要提供 CLA，并相应地装饰 PR（例如状态检查、评论）。只需按照机器人 提供的指示操作。你只需在所有使用该 CLA 的仓库中完成一次此操作。

本项目已采用 微软开源行为准则。 更多信息请参阅行为准则常见问题或 联系 [email protected] 以获取额外问题或建议。

---

准备好开始你的 MCP 旅程了吗？从 模块 00 - MCP 介绍 开始，迈出进入 Model Context Protocol 开发世界的第一步！

🎒 其他课程

我们的团队还提供其他课程！查看：

LangChain

Azure / Edge / MCP / Agents

---

生成式 AI 系列

---

核心学习

---

Copilot 系列

---

免责声明： 本文件由 AI 翻译服务 Co-op Translator 翻译完成。尽管我们力求准确，但请注意，自动翻译可能包含错误或不准确之处。原始语言版文件应视为权威来源。对于重要信息，建议使用专业人工翻译。我们对因使用本翻译而产生的任何误解或误释不承担责任。