docs: make Chinese README the default

This commit is contained in:
wehub-resource-sync
2026-07-13 11:08:54 +00:00
parent 254d7435a3
commit 5ac266cc8d
+197 -195
View File
@@ -1,3 +1,9 @@
<!-- WEHUB_ZH_README -->
> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理,属于社区翻译,非官方中文文档。
> [English](./README.en.md) · [原始项目](https://github.com/microsoft/mcp-for-beginners) · [上游 README](https://github.com/microsoft/mcp-for-beginners/blob/HEAD/README.md)
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
![MCP-for-beginners](./images/mcp-beginners.png)
[![GitHub contributors](https://img.shields.io/github/contributors/microsoft/mcp-for-beginners.svg)](https://GitHub.com/microsoft/mcp-for-beginners/graphs/contributors)
@@ -12,214 +18,214 @@
[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG)
Follow these steps to get started using these resources:
1. **Fork the Repository**: Click [![GitHub forks](https://img.shields.io/github/forks/microsoft/mcp-for-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/mcp-for-beginners/fork)
2. **Clone the Repository**: `git clone https://github.com/microsoft/mcp-for-beginners.git`
3. **Join The** [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG)
按照以下步骤开始使用这些资源:
1. **Fork 仓库**:点击 [![GitHub forks](https://img.shields.io/github/forks/microsoft/mcp-for-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/mcp-for-beginners/fork)
2. **克隆仓库** `git clone https://github.com/microsoft/mcp-for-beginners.git`
3. **加入** [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG)
### 🌐 Multi-Language Support
### 🌐 多语言支持
#### Supported via GitHub Action (Automated & Always Up-to-Date)
#### 通过 GitHub Action 提供支持(自动化且始终保持最新)
<!-- CO-OP TRANSLATOR LANGUAGES TABLE START -->
[Arabic](./translations/ar/README.md) | [Bengali](./translations/bn/README.md) | [Bulgarian](./translations/bg/README.md) | [Burmese (Myanmar)](./translations/my/README.md) | [Chinese (Simplified)](./translations/zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](./translations/zh-HK/README.md) | [Chinese (Traditional, Macau)](./translations/zh-MO/README.md) | [Chinese (Traditional, Taiwan)](./translations/zh-TW/README.md) | [Croatian](./translations/hr/README.md) | [Czech](./translations/cs/README.md) | [Danish](./translations/da/README.md) | [Dutch](./translations/nl/README.md) | [Estonian](./translations/et/README.md) | [Finnish](./translations/fi/README.md) | [French](./translations/fr/README.md) | [German](./translations/de/README.md) | [Greek](./translations/el/README.md) | [Hebrew](./translations/he/README.md) | [Hindi](./translations/hi/README.md) | [Hungarian](./translations/hu/README.md) | [Indonesian](./translations/id/README.md) | [Italian](./translations/it/README.md) | [Japanese](./translations/ja/README.md) | [Kannada](./translations/kn/README.md) | [Khmer](./translations/km/README.md) | [Korean](./translations/ko/README.md) | [Lithuanian](./translations/lt/README.md) | [Malay](./translations/ms/README.md) | [Malayalam](./translations/ml/README.md) | [Marathi](./translations/mr/README.md) | [Nepali](./translations/ne/README.md) | [Nigerian Pidgin](./translations/pcm/README.md) | [Norwegian](./translations/no/README.md) | [Persian (Farsi)](./translations/fa/README.md) | [Polish](./translations/pl/README.md) | [Portuguese (Brazil)](./translations/pt-BR/README.md) | [Portuguese (Portugal)](./translations/pt-PT/README.md) | [Punjabi (Gurmukhi)](./translations/pa/README.md) | [Romanian](./translations/ro/README.md) | [Russian](./translations/ru/README.md) | [Serbian (Cyrillic)](./translations/sr/README.md) | [Slovak](./translations/sk/README.md) | [Slovenian](./translations/sl/README.md) | [Spanish](./translations/es/README.md) | [Swahili](./translations/sw/README.md) | [Swedish](./translations/sv/README.md) | [Tagalog (Filipino)](./translations/tl/README.md) | [Tamil](./translations/ta/README.md) | [Telugu](./translations/te/README.md) | [Thai](./translations/th/README.md) | [Turkish](./translations/tr/README.md) | [Ukrainian](./translations/uk/README.md) | [Urdu](./translations/ur/README.md) | [Vietnamese](./translations/vi/README.md)
> **Prefer to Clone Locally?**
> **更倾向于在本地克隆?**
>
> This repository includes 50+ language translations which significantly increases the download size. To clone without translations, use sparse checkout:
> 本仓库包含 50 多种语言翻译,会显著增加下载体积。若要在克隆时排除翻译内容,请使用 sparse checkout(稀疏检出):
>
> **Bash / macOS / Linux:**
> **Bash / macOS / Linux**
> ```bash
> 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):**
> **CMD (Windows)**
> ```cmd
> 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"
> ```
>
> This gives you everything you need to complete the course with a much faster download.
> 这样你就能获得完成课程所需的全部内容,同时下载速度会快得多。
<!-- CO-OP TRANSLATOR LANGUAGES TABLE END -->
# 🚀 Model Context Protocol (MCP) Curriculum for Beginners
# 🚀 面向初学者的 Model Context Protocol (MCP) 课程
## **Learn MCP with Hands-on Code Examples in C#, Java, JavaScript, Rust, Python, and TypeScript**
## **通过 C#JavaJavaScriptRustPython TypeScript 的动手代码示例学习 MCP**
## 🧠 Overview of the Model Context Protocol Curriculum
Welcome to your journey into the Model Context Protocol! If you've ever wondered how AI applications communicate with different tools and services, you're about to discover the elegant solution that's transforming how developers build intelligent systems.
## 🧠 Model Context Protocol 课程概览
欢迎来到 Model Context Protocol 的学习之旅!如果你曾好奇 AI 应用如何与不同工具和服务通信,你即将发现一种优雅的解决方案——它正在改变开发者构建智能系统的方式。
Think of MCP as a universal translator for AI applications - just like how USB ports let you connect any device to your computer, MCP lets AI models connect to any tool or service in a standardized way. Whether you're building your first chatbot or working on complex AI workflows, understanding MCP will give you the power to create more capable and flexible applications.
可以把 MCP 想象成 AI 应用的通用翻译器——就像 USB 接口让你能把任何设备连接到电脑一样,MCP 让 AI 模型能以标准化方式连接任何工具或服务。无论你是在构建第一个聊天机器人,还是在处理复杂的 AI 工作流,理解 MCP 都能让你创建更强大、更灵活的应用。
This curriculum is designed with patience and care for your learning journey. We'll start with simple concepts you already understand and gradually build your expertise through hands-on practice in your favorite programming language. Every step includes clear explanations, practical examples, and plenty of encouragement along the way.
本课程耐心而细致地围绕你的学习路径设计。我们会从你已熟悉的简单概念出发,通过你喜爱的编程语言中的动手实践,逐步提升你的能力。每一步都包含清晰的讲解、实用的示例,以及一路上的鼓励与支持。
By the time you complete this journey, you'll have the confidence to build your own MCP servers, integrate them with popular AI platforms, and understand how this technology is reshaping the future of AI development. Let's begin this exciting adventure together!
完成这段学习之旅后,你将有信心构建自己的 MCP 服务器,将其与主流 AI 平台集成,并理解这项技术如何重塑 AI 开发的未来。让我们一起开启这段激动人心的旅程吧!
### Official Documentation and Specifications
### 官方文档与规范
This curriculum is aligned with **MCP Specification 2025-11-25** (the latest stable release). The MCP specification uses date-based versioning (YYYY-MM-DD format) to ensure clear protocol version tracking.
本课程与 **MCP Specification 2025-11-25**(最新稳定版本)保持一致。MCP 规范采用基于日期的版本号(YYYY-MM-DD 格式),以确保协议版本追踪清晰明确。
> **Looking ahead:** a release candidate for the next specification version, **2026-07-28**, is scheduled to ship on July 28, 2026. It makes the protocol stateless at the transport layer, formalizes an Extensions framework (MCP Apps, Tasks), hardens authorization, and deprecates Roots, Sampling, and Logging. See [What's Changing in MCP: The 2026-07-28 Release Candidate](./01-CoreConcepts/mcp-2026-07-28-release-candidate.md) for a full breakdown.
> **展望未来:** 下一版规范的候选发布版本 **2026-07-28** 计划于 2026 年 7 月 28 日发布。该版本将在传输层使协议无状态(stateless),正式确立 Extensions 框架(MCP AppsTasks),加强授权机制,并弃用 RootsSampling Logging。完整说明请参阅 [What's Changing in MCP: The 2026-07-28 Release Candidate](./01-CoreConcepts/mcp-2026-07-28-release-candidate.md)
These resources become more valuable as your understanding grows, but don't feel pressured to read everything immediately. Start with the areas that interest you most!
- 📘 [MCP Documentation](https://modelcontextprotocol.io/) This is your go-to resource for step-by-step tutorials and user guides. The documentation is written with beginners in mind, providing clear examples you can follow along with at your own pace.
- 📜 [MCP Specification](https://modelcontextprotocol.io/specification/2025-11-25) Think of this as your comprehensive reference manual. As you work through the curriculum, you'll find yourself returning here to look up specific details and explore advanced features.
- 📜 [MCP Specification Versioning](https://modelcontextprotocol.io/specification/versioning) This contains information about protocol version history and how MCP uses date-based versioning (YYYY-MM-DD format).
- 🧑‍💻 [MCP GitHub Repository](https://github.com/modelcontextprotocol) Here you'll find SDKs, tools, and code samples in multiple programming languages. It's like a treasure trove of practical examples and ready-to-use components.
- 🌐 [MCP Community](https://github.com/orgs/modelcontextprotocol/discussions) Join fellow learners and experienced developers in discussions about MCP. It's a supportive community where questions are welcome and knowledge is shared freely.
## Learning Objectives
随着理解的加深,这些资源会愈发有价值,但不必有立刻读完所有内容的压力。先从你最感兴趣的领域开始吧!
- 📘 [MCP Documentation](https://modelcontextprotocol.io/) 这是你获取分步教程和用户指南的首选资源。文档面向初学者编写,提供清晰示例,你可以按自己的节奏跟随学习。
- 📜 [MCP Specification](https://modelcontextprotocol.io/specification/2025-11-25) 可将其视为你的全面参考手册。在学习课程的过程中,你会经常回到这里查阅具体细节并探索高级功能。
- 📜 [MCP Specification Versioning](https://modelcontextprotocol.io/specification/versioning) 其中包含协议版本历史信息,以及 MCP 如何使用基于日期的版本号(YYYY-MM-DD 格式)。
- 🧑‍💻 [MCP GitHub Repository](https://github.com/modelcontextprotocol) 在这里你可以找到多种编程语言的 SDK、工具和代码示例。它就像一座宝库,满是实用示例和可直接使用的组件。
- 🌐 [MCP Community](https://github.com/orgs/modelcontextprotocol/discussions) fellow learners 和经验丰富的开发者一起讨论 MCP。这是一个互助社区,欢迎提问,知识自由分享。
By the end of this curriculum, you'll feel confident and excited about your new abilities. Here's what you'll achieve:
## 学习目标
**Understand MCP fundamentals**: You'll grasp what the Model Context Protocol is and why it's revolutionizing how AI applications work together, using analogies and examples that make sense.
完成本课程后,你将对自己的新能力充满信心并充满期待。以下是你将达成的目标:
**Build your first MCP server**: You'll create a working MCP server in your preferred programming language, starting with simple examples and growing your skills step by step.
**理解 MCP 基础**:你将掌握 Model Context Protocol(模型上下文协议)是什么,以及它为何正在革新 AI 应用之间的协作方式,并通过易于理解的类比和示例来加深认识。
**Connect AI models to real tools**: You'll learn how to bridge the gap between AI models and actual services, giving your applications powerful new capabilities.
**构建你的第一个 MCP 服务器**:你将以自己偏好的编程语言创建一个可运行的 MCP 服务器,从简单示例起步,循序渐进地提升技能。
**Implement security best practices**: You'll understand how to keep your MCP implementations safe and secure, protecting both your applications and your users.
**将 AI 模型连接到真实工具**:你将学习如何弥合 AI 模型与实际服务之间的鸿沟,为你的应用赋予强大的新能力。
**Deploy with confidence**: You'll know how to take your MCP projects from development to production, with practical deployment strategies that work in the real world.
**实施安全最佳实践**:你将了解如何保障 MCP 实现的安全可靠,保护你的应用和用户。
**Join the MCP community**: You'll become part of a growing community of developers who are shaping the future of AI application development.
**自信地部署**:你将掌握如何将 MCP 项目从开发推向生产,并运用在真实环境中行之有效的实用部署策略。
## Essential Background
**加入 MCP 社区**:你将成为不断壮大的开发者社区的一员,共同塑造 AI 应用开发的未来。
Before we dive into MCP specifics, let's make sure you feel comfortable with some foundational concepts. Don't worry if you're not an expert in these areas - we'll explain everything you need to know as we go!
## 必备背景知识
### Understanding Protocols (The Foundation)
在深入 MCP 细节之前,让我们先确保你对一些基础概念感到得心应手。即便你在这些领域并非专家也无需担心——我们会在学习过程中解释你需要了解的一切!
Think of a protocol like the rules for a conversation. When you call a friend, you both know to say "hello" when you answer, take turns speaking, and say "goodbye" when you're done. Computer programs need similar rules to communicate effectively.
### 理解协议(基础)
MCP is a protocol - a set of agreed-upon rules that help AI models and applications have productive "conversations" with tools and services. Just like how having conversation rules makes human communication smoother, having MCP makes AI application communication much more reliable and powerful.
可以把协议想象成一场对话的规则。当你给朋友打电话时,你们都知道接听时说「你好」,轮流说话,结束时说「再见」。计算机程序也需要类似的规则才能有效通信。
### Client-Server Relationships (How Programs Work Together)
MCP 是一种协议——一套约定好的规则,帮助 AI 模型和应用与工具和服务进行富有成效的「对话」。就像对话规则让人类交流更顺畅一样,MCP 让 AI 应用之间的通信更加可靠、更加强大。
You already use client-server relationships every day! When you use a web browser (the client) to visit a website, you're connecting to a web server that sends you the page content. The browser knows how to ask for information, and the server knows how to respond.
### 客户端-服务器关系(程序如何协同工作)
In MCP, we have a similar relationship: AI models act as clients that request information or actions, while MCP servers provide those capabilities. It's like having a helpful assistant (the server) that the AI can ask to perform specific tasks.
你每天都在使用客户端-服务器关系!当你用 Web 浏览器(客户端)访问网站时,你连接的是向你发送页面内容的 Web 服务器。浏览器知道如何请求信息,服务器知道如何响应。
### Why Standardization Matters (Making Things Work Together)
在 MCP 中,我们也有类似的关系:AI 模型充当客户端,请求信息或操作;MCP 服务器则提供这些能力。这就像有一个得力助手(服务器),AI 可以请它执行特定任务。
Imagine if every car manufacturer used different shaped gas pumps - you'd need a different adapter for each car! Standardization means agreeing on common approaches so things work together seamlessly.
### 为何标准化很重要(让事物协同工作)
MCP provides this standardization for AI applications. Instead of every AI model needing custom code to work with every tool, MCP creates a universal way for them to communicate. This means developers can build tools once and have them work with many different AI systems.
想象一下,如果每家汽车制造商都使用不同形状的加油泵——你就需要为每辆车配备不同的转接头!标准化意味着就通用方法达成一致,使事物能够无缝协同工作。
## 🧭 Your Learning Path Overview
MCP 为 AI 应用提供了这种标准化。与其让每个 AI 模型都需要定制代码才能与每个工具配合,MCP 为它们创造了一种通用的通信方式。这意味着开发者可以一次构建工具,就能与多种不同的 AI 系统配合使用。
Your MCP journey is carefully structured to build your confidence and skills progressively. Each phase introduces new concepts while reinforcing what you've already learned.
## 🧭 学习路径概览
### 🌱 Foundation Phase: Understanding the Basics (Modules 0-2)
你的 MCP 学习之旅经过精心设计,将逐步建立你的信心与技能。每个阶段都会引入新概念,同时巩固你已学内容。
This is where your adventure begins! We'll introduce you to MCP concepts using familiar analogies and simple examples. You'll understand what MCP is, why it exists, and how it fits into the larger world of AI development.
### 🌱 基础阶段:理解基础知识(模块 0-2)
**Module 0 - Introduction to MCP**: We'll start by exploring what MCP is and why it's so important for modern AI applications. You'll see real-world examples of MCP in action and understand how it solves common problems developers face.
你的冒险从这里开始!我们将用熟悉的类比和简单示例介绍 MCP 概念。你将理解 MCP 是什么、为何存在,以及它如何融入更广阔的 AI 开发生态。
**Module 1 - Core Concepts Explained**: Here you'll learn the essential building blocks of MCP. We'll use plenty of analogies and visual examples to make sure these concepts feel natural and understandable.
**模块 0 - MCP 简介**:我们将首先探索 MCP 是什么,以及它对现代 AI 应用为何如此重要。你将看到 MCP 在实际场景中的真实示例,并理解它如何解决开发者面临的常见问题。
**Module 2 - Security in MCP**: Security might sound intimidating, but we'll show you how MCP includes built-in safety features and teach you best practices that protect your applications from the start.
**模块 1 - 核心概念详解**:在这里你将学习 MCP 的基本构建块。我们会大量使用类比和可视化示例,确保这些概念感觉自然且易于理解。
### 🔨 Building Phase: Creating Your First Implementations (Module 3)
**模块 2 - MCP 中的安全**:安全听起来可能令人望而生畏,但我们会展示 MCP 如何内置安全特性,并教你从一开始就保护应用的最佳实践。
Now the real fun begins! You'll get hands-on experience building actual MCP servers and clients. Don't worry - we'll start simple and guide you through every step.
### 🔨 构建阶段:创建你的首批实现(模块 3)
This module includes multiple hands-on guides that let you practice in your preferred programming language. You'll create your first server, build a client to connect to it, and even integrate with popular development tools like VS Code.
真正的乐趣现在开始!你将动手构建真实的 MCP 服务器和客户端。别担心——我们会从简单入手,一步步引导你完成。
Each guide includes complete code examples, troubleshooting tips, and explanations of why we make specific design choices. By the end of this phase, you'll have working MCP implementations you can be proud of!
本模块包含多份动手指南,让你可以用自己偏好的编程语言进行练习。你将创建第一个服务器、构建连接它的客户端,甚至与 VS Code 等流行开发工具集成。
### 🚀 Growing Phase: Advanced Concepts and Real-World Application (Modules 4-5)
每份指南都包含完整代码示例、故障排查技巧,以及对特定设计选择原因的说明。到本阶段结束时,你将拥有值得骄傲的、可运行的 MCP 实现!
With the basics mastered, you're ready to explore more sophisticated MCP features. We'll cover practical implementation strategies, debugging techniques, and advanced topics like multi-modal AI integration.
### 🚀 成长阶段:高级概念与实际应用(模块 4-5)
You'll also learn how to scale your MCP implementations for production use and integrate with cloud platforms like Azure. These modules prepare you to build MCP solutions that can handle real-world demands.
掌握基础后,你已准备好探索更复杂的 MCP 功能。我们将涵盖实用实现策略、调试技巧,以及多模态 AI 集成等高级主题。
### 🌟 Mastery Phase: Community and Specialization (Modules 6-11)
你还将学习如何为生产使用扩展 MCP 实现,并与 Azure 等云平台集成。这些模块将帮助你构建能够应对真实世界需求的 MCP 解决方案。
The final phase focuses on joining the MCP community and specializing in areas that interest you most. You'll learn how to contribute to open-source MCP projects, implement advanced authentication patterns, and build comprehensive database-integrated solutions.
### 🌟 精通阶段:社区与专业化(模块 6-11)
Module 11 deserves special mention - it's a complete 13-lab hands-on learning path that teaches you to build production-ready MCP servers with PostgreSQL integration. It's like a capstone project that brings together everything you've learned!
最后阶段聚焦于加入 MCP 社区,并在你最感兴趣的领域深耕。你将学习如何为开源 MCP 项目做贡献、实现高级认证模式,并构建全面的数据库集成解决方案。
### 📚 Complete Curriculum Structure
模块 11 值得特别一提——它是一条完整的 13 个实验动手学习路径,教你构建可与 PostgreSQL 集成的生产级 MCP 服务器。它就像一份毕业设计,将你所学融会贯通!
### 📚 完整课程结构
| Module | Topic | Description | Link |
|--------|-------|-------------|------|
| **Module 0-3: Fundamentals** | | | |
| 00 | Introduction to MCP | Overview of the Model Context Protocol and its significance in AI pipelines | [Read more](./00-Introduction/README.md) |
| 01 | Core Concepts Explained | In-depth exploration of core MCP concepts | [Read more](./01-CoreConcepts/README.md) |
| 1.1 | What's Changing in MCP (2026-07-28 RC) | Stateless protocol, Extensions framework, and feature deprecations coming in the next spec version | [Guide](./01-CoreConcepts/mcp-2026-07-28-release-candidate.md) |
| 02 | Security in MCP | Security threats and best practices | [Read more](./02-Security/README.md) |
| 03 | Getting Started with MCP | Environment setup, basic servers/clients, integration | [Read more](./03-GettingStarted/README.md) |
| 00 | Introduction to MCP | Model Context Protocol 概览及其在 AI 流水线中的意义 | [Read more](./00-Introduction/README.md) |
| 01 | Core Concepts Explained | 深入探索 MCP 核心概念 | [Read more](./01-CoreConcepts/README.md) |
| 1.1 | What's Changing in MCP (2026-07-28 RC) | 无状态协议、Extensions 框架,以及下一版规范中的功能弃用 | [Guide](./01-CoreConcepts/mcp-2026-07-28-release-candidate.md) |
| 02 | Security in MCP | 安全威胁与最佳实践 | [Read more](./02-Security/README.md) |
| 03 | Getting Started with MCP | 环境搭建、基础服务器/客户端、集成 | [Read more](./03-GettingStarted/README.md) |
| **Module 3: Building Your First Server & Client** | | | |
| 3.1 | First Server | Create your first MCP server | [Guide](./03-GettingStarted/01-first-server/README.md) |
| 3.2 | First Client | Develop a basic MCP client | [Guide](./03-GettingStarted/02-client/README.md) |
| 3.3 | Client with LLM | Integrate large language models | [Guide](./03-GettingStarted/03-llm-client/README.md) |
| 3.4 | VS Code Integration | Consume MCP servers in VS Code | [Guide](./03-GettingStarted/04-vscode/README.md) |
| 3.5 | stdio Server | Create servers using stdio transport | [Guide](./03-GettingStarted/05-stdio-server/README.md) |
| 3.6 | HTTP Streaming | Implement HTTP streaming in MCP | [Guide](./03-GettingStarted/06-http-streaming/README.md) |
| 3.7 | Microsoft Foundry Toolkit | Use Microsoft Foundry Toolkit with MCP | [Guide](./03-GettingStarted/07-aitk/README.md) |
| 3.8 | Testing | Test your MCP server implementation | [Guide](./03-GettingStarted/08-testing/README.md) |
| 3.9 | Deployment | Deploy MCP servers to production | [Guide](./03-GettingStarted/09-deployment/README.md) |
| 3.10 | Advanced server usage | Use advanced servers for advanced feature usage and improved architecture | [Guide](./03-GettingStarted/10-advanced/README.md) |
| 3.11 | Simple auth | A chapter showing you auth from the beginning and RBAC | [Guide](./03-GettingStarted/11-simple-auth/README.md) |
| 3.12 | MCP Hosts | Configure Claude Desktop, Cursor, Cline, and other MCP hosts | [Guide](./03-GettingStarted/12-mcp-hosts/README.md) |
| 3.13 | MCP Inspector | Debug and test MCP servers with the Inspector tool | [Guide](./03-GettingStarted/13-mcp-inspector/README.md) |
| 3.14 | Sampling | Use sampling to collaborate with the client | [Guide](./03-GettingStarted/14-sampling/README.md) |
| 3.15 | MCP Apps | Build MCP Apps | [Guide](./03-GettingStarted/15-mcp-apps/README.md) |
| 3.1 | First Server | 创建你的第一个 MCP 服务器 | [Guide](./03-GettingStarted/01-first-server/README.md) |
| 3.2 | First Client | 开发基础 MCP 客户端 | [Guide](./03-GettingStarted/02-client/README.md) |
| 3.3 | Client with LLM | 集成大语言模型 | [Guide](./03-GettingStarted/03-llm-client/README.md) |
| 3.4 | VS Code Integration | 在 VS Code 中使用 MCP 服务器 | [Guide](./03-GettingStarted/04-vscode/README.md) |
| 3.5 | stdio Server | 使用 stdio 传输创建服务器 | [Guide](./03-GettingStarted/05-stdio-server/README.md) |
| 3.6 | HTTP Streaming | 在 MCP 中实现 HTTP 流式传输 | [Guide](./03-GettingStarted/06-http-streaming/README.md) |
| 3.7 | Microsoft Foundry Toolkit | Microsoft Foundry Toolkit 与 MCP 配合使用 | [Guide](./03-GettingStarted/07-aitk/README.md) |
| 3.8 | Testing | 测试你的 MCP 服务器实现 | [Guide](./03-GettingStarted/08-testing/README.md) |
| 3.9 | Deployment | 将 MCP 服务器部署到生产环境 | [Guide](./03-GettingStarted/09-deployment/README.md) |
| 3.10 | Advanced server usage | 使用高级服务器实现高级功能并改进架构 | [Guide](./03-GettingStarted/10-advanced/README.md) |
| 3.11 | Simple auth | 从零讲解认证与 RBAC 的章节 | [Guide](./03-GettingStarted/11-simple-auth/README.md) |
| 3.12 | MCP Hosts | 配置 Claude DesktopCursorCline 及其他 MCP 宿主 | [Guide](./03-GettingStarted/12-mcp-hosts/README.md) |
| 3.13 | MCP Inspector | 使用 Inspector 工具调试和测试 MCP 服务器 | [Guide](./03-GettingStarted/13-mcp-inspector/README.md) |
| 3.14 | Sampling | 使用 sampling 与客户端协作 | [Guide](./03-GettingStarted/14-sampling/README.md) |
| 3.15 | MCP Apps | 构建 MCP Apps | [Guide](./03-GettingStarted/15-mcp-apps/README.md) |
| **Module 4-5: Practical & Advanced** | | | |
| 04 | Practical Implementation | SDKs, debugging, testing, reusable prompt templates | [Read more](./04-PracticalImplementation/README.md) |
| 4.1 | Pagination | Handle large result sets with cursor-based pagination | [Guide](./04-PracticalImplementation/pagination/README.md) |
| 05 | Advanced Topics in MCP | Multi-modal AI, scaling, enterprise use | [Read more](./05-AdvancedTopics/README.md) |
| 5.1 | Azure Integration | MCP Integration with Azure | [Guide](./05-AdvancedTopics/mcp-integration/README.md) |
| 5.2 | Multi-modality | Working with multiple modalities | [Guide](./05-AdvancedTopics/mcp-multi-modality/README.md) |
| 5.3 | OAuth2 Demo | Implement OAuth2 authentication | [Guide](./05-AdvancedTopics/mcp-oauth2-demo/README.md) |
| 5.4 | Root Contexts | Understand and implement root contexts | [Guide](./05-AdvancedTopics/mcp-root-contexts/README.md) |
| 5.5 | Routing | MCP routing strategies | [Guide](./05-AdvancedTopics/mcp-routing/README.md) |
| 5.6 | Sampling | Sampling techniques in MCP | [Guide](./05-AdvancedTopics/mcp-sampling/README.md) |
| 5.7 | Scaling | Scale MCP implementations | [Guide](./05-AdvancedTopics/mcp-scaling/README.md) |
| 5.8 | Security | Advanced security considerations | [Guide](./05-AdvancedTopics/mcp-security/README.md) |
| 5.9 | Web Search | Implement web search capabilities | [Guide](./05-AdvancedTopics/web-search-mcp/README.md) |
| 5.10 | Realtime Streaming | Build realtime streaming functionality | [Guide](./05-AdvancedTopics/mcp-realtimestreaming/README.md) |
| 5.11 | Realtime Search | Implement realtime search | [Guide](./05-AdvancedTopics/mcp-realtimesearch/README.md) |
| 5.12 | Entra ID Auth | Authentication with Microsoft Entra ID | [Guide](./05-AdvancedTopics/mcp-security-entra/README.md) |
| 5.13 | Foundry Integration | Integrate with Microsoft Foundry | [Guide](./05-AdvancedTopics/mcp-foundry-agent-integration/README.md) |
| 5.14 | Context Engineering | Techniques for effective context engineering | [Guide](./05-AdvancedTopics/mcp-contextengineering/README.md) |
| 5.15 | MCP Custom Transport | Custom Transport implementations | [Guide](./05-AdvancedTopics/mcp-transport/README.md) |
| 5.16 | Protocol Features | Progress notifications, cancellation, resource templates | [Guide](./05-AdvancedTopics/mcp-protocol-features/README.md) |
| 5.17 | Adversarial Multi-Agent Reasoning | Two agents argue opposite sides using shared MCP tools, evaluated by a judge agent | [Guide](./05-AdvancedTopics/mcp-adversarial-agents/README.md) |
| 04 | Practical Implementation | SDK、调试、测试、可复用提示模板 | [Read more](./04-PracticalImplementation/README.md) |
| 4.1 | Pagination | 使用基于游标的分页处理大型结果集 | [Guide](./04-PracticalImplementation/pagination/README.md) |
| 05 | Advanced Topics in MCP | 多模态 AI、扩展、企业级使用 | [Read more](./05-AdvancedTopics/README.md) |
| 5.1 | Azure Integration | 与 Azure 的 MCP 集成 | [Guide](./05-AdvancedTopics/mcp-integration/README.md) |
| 5.2 | Multi-modality | 处理多种模态 | [Guide](./05-AdvancedTopics/mcp-multi-modality/README.md) |
| 5.3 | OAuth2 Demo | 实现 OAuth2 认证 | [Guide](./05-AdvancedTopics/mcp-oauth2-demo/README.md) |
| 5.4 | Root Contexts | 理解并实现 root contexts | [Guide](./05-AdvancedTopics/mcp-root-contexts/README.md) |
| 5.5 | Routing | MCP 路由策略 | [Guide](./05-AdvancedTopics/mcp-routing/README.md) |
| 5.6 | Sampling | MCP 中的 sampling 技术 | [Guide](./05-AdvancedTopics/mcp-sampling/README.md) |
| 5.7 | Scaling | 扩展 MCP 实现 | [Guide](./05-AdvancedTopics/mcp-scaling/README.md) |
| 5.8 | Security | 高级安全考量 | [Guide](./05-AdvancedTopics/mcp-security/README.md) |
| 5.9 | Web Search | 实现 Web 搜索能力 | [Guide](./05-AdvancedTopics/web-search-mcp/README.md) |
| 5.10 | Realtime Streaming | 构建实时流式传输功能 | [Guide](./05-AdvancedTopics/mcp-realtimestreaming/README.md) |
| 5.11 | Realtime Search | 实现实时搜索 | [Guide](./05-AdvancedTopics/mcp-realtimesearch/README.md) |
| 5.12 | Entra ID Auth | 使用 Microsoft Entra ID 进行认证 | [Guide](./05-AdvancedTopics/mcp-security-entra/README.md) |
| 5.13 | Foundry Integration | Microsoft Foundry 集成 | [Guide](./05-AdvancedTopics/mcp-foundry-agent-integration/README.md) |
| 5.14 | Context Engineering | 高效上下文工程(Context Engineering)技术 | [Guide](./05-AdvancedTopics/mcp-contextengineering/README.md) |
| 5.15 | MCP Custom Transport | 自定义 Transport 实现 | [Guide](./05-AdvancedTopics/mcp-transport/README.md) |
| 5.16 | Protocol Features | 进度通知、取消、资源模板 | [Guide](./05-AdvancedTopics/mcp-protocol-features/README.md) |
| 5.17 | Adversarial Multi-Agent Reasoning | 两个智能体使用共享 MCP 工具持相反立场辩论,由评判智能体评估 | [Guide](./05-AdvancedTopics/mcp-adversarial-agents/README.md) |
| **Module 6-10: Community & Best Practices** | | | |
| 06 | Community Contributions | How to contribute to the MCP ecosystem | [Guide](./06-CommunityContributions/README.md) |
| 07 | Insights from Early Adoption | Real-world implementation stories | [Guide](./07-LessonsfromEarlyAdoption/README.md) |
| 08 | Best Practices for MCP | Performance, fault-tolerance, resilience | [Guide](./08-BestPractices/README.md) |
| 09 | MCP Case Studies | Practical implementation examples | [Guide](./09-CaseStudy/README.md) |
| 10 | Hands-on Workshop | Building an MCP Server with Microsoft Foundry Toolkit | [Lab](./10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/README.md) |
| 06 | Community Contributions | 如何为 MCP 生态做贡献 | [Guide](./06-CommunityContributions/README.md) |
| 07 | Insights from Early Adoption | 真实世界的实现案例 | [Guide](./07-LessonsfromEarlyAdoption/README.md) |
| 08 | Best Practices for MCP | 性能、容错、韧性 | [Guide](./08-BestPractices/README.md) |
| 09 | MCP Case Studies | 实用实现示例 | [Guide](./09-CaseStudy/README.md) |
| 10 | Hands-on Workshop | 使用 Microsoft Foundry Toolkit 构建 MCP 服务器 | [Lab](./10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/README.md) |
| **Module 11: MCP Server Hands On Lab** | | | |
| 11 | MCP Server Database Integration | Comprehensive 13-lab hands-on learning path for PostgreSQL integration | [Labs](./11-MCPServerHandsOnLabs/README.md) |
| 11.1 | Introduction | Overview of MCP with database integration and retail analytics use case | [Lab 00](./11-MCPServerHandsOnLabs/00-Introduction/README.md) |
| 11.2 | Core Architecture | Understanding MCP server architecture, database layers, and security patterns | [Lab 01](./11-MCPServerHandsOnLabs/01-Architecture/README.md) |
| 11.3 | Security & Multi-Tenancy | Row Level Security, authentication, and multi-tenant data access | [Lab 02](./11-MCPServerHandsOnLabs/02-Security/README.md) |
| 11.4 | Environment Setup | Setting up development environment, Docker, Azure resources | [Lab 03](./11-MCPServerHandsOnLabs/03-Setup/README.md) |
| 11.5 | Database Design | PostgreSQL setup, retail schema design, and sample data | [Lab 04](./11-MCPServerHandsOnLabs/04-Database/README.md) |
| 11.6 | MCP Server Implementation | Building the FastMCP server with database integration | [Lab 05](./11-MCPServerHandsOnLabs/05-MCP-Server/README.md) |
| 11.7 | Tool Development | Creating database query tools and schema introspection | [Lab 06](./11-MCPServerHandsOnLabs/06-Tools/README.md) |
| 11.8 | Semantic Search | Implementing vector embeddings with Azure OpenAI and pgvector | [Lab 07](./11-MCPServerHandsOnLabs/07-Semantic-Search/README.md) |
| 11.9 | Testing & Debugging | Testing strategies, debugging tools, and validation approaches | [Lab 08](./11-MCPServerHandsOnLabs/08-Testing/README.md) |
| 11.10 | VS Code Integration | Configuring VS Code MCP integration and AI Chat usage | [Lab 09](./11-MCPServerHandsOnLabs/09-VS-Code/README.md) |
| 11.11 | Deployment Strategies | Docker deployment, Azure Container Apps, and scaling considerations | [Lab 10](./11-MCPServerHandsOnLabs/10-Deployment/README.md) |
| 11.12 | Monitoring | Application Insights, logging, performance monitoring | [Lab 11](./11-MCPServerHandsOnLabs/11-Monitoring/README.md) |
| 11.13 | Best Practices | Performance optimization, security hardening, and production tips | [Lab 12](./11-MCPServerHandsOnLabs/12-Best-Practices/README.md) |
| 11 | MCP Server Database Integration | 面向 PostgreSQL 集成的完整 13 个实验动手学习路径 | [Labs](./11-MCPServerHandsOnLabs/README.md) |
| 11.1 | Introduction | MCP 与数据库集成概览及零售分析用例 | [Lab 00](./11-MCPServerHandsOnLabs/00-Introduction/README.md) |
| 11.2 | Core Architecture | 理解 MCP 服务器架构、数据库层与安全模式 | [Lab 01](./11-MCPServerHandsOnLabs/01-Architecture/README.md) |
| 11.3 | Security & Multi-Tenancy | 行级安全(Row Level Security)、认证与多租户数据访问 | [Lab 02](./11-MCPServerHandsOnLabs/02-Security/README.md) |
| 11.4 | Environment Setup | 搭建开发环境、DockerAzure 资源 | [Lab 03](./11-MCPServerHandsOnLabs/03-Setup/README.md) |
| 11.5 | Database Design | PostgreSQL 搭建、零售模式设计与示例数据 | [Lab 04](./11-MCPServerHandsOnLabs/04-Database/README.md) |
| 11.6 | MCP Server Implementation | 构建带数据库集成的 FastMCP 服务器 | [Lab 05](./11-MCPServerHandsOnLabs/05-MCP-Server/README.md) |
| 11.7 | Tool Development | 创建数据库查询工具与模式内省 | [Lab 06](./11-MCPServerHandsOnLabs/06-Tools/README.md) |
| 11.8 | Semantic Search | 使用 Azure OpenAI pgvector 实现向量嵌入 | [Lab 07](./11-MCPServerHandsOnLabs/07-Semantic-Search/README.md) |
| 11.9 | Testing & Debugging | 测试策略、调试工具与验证方法 | [Lab 08](./11-MCPServerHandsOnLabs/08-Testing/README.md) |
| 11.10 | VS Code Integration | 配置 VS Code MCP 集成与 AI Chat 使用 | [Lab 09](./11-MCPServerHandsOnLabs/09-VS-Code/README.md) |
| 11.11 | Deployment Strategies | Docker 部署、Azure Container Apps 与扩展考量 | [Lab 10](./11-MCPServerHandsOnLabs/10-Deployment/README.md) |
| 11.12 | Monitoring | Application Insights、日志与性能监控 | [Lab 11](./11-MCPServerHandsOnLabs/11-Monitoring/README.md) |
| 11.13 | Best Practices | 性能优化、安全加固与生产环境技巧 | [Lab 12](./11-MCPServerHandsOnLabs/12-Best-Practices/README.md) |
| **Module 12: MCP Tooling** | | | |
| 12.1 | Tooling | MCP usage in Copilot App | [ Guide ](./12-tooling/README.md) |
| 12.1 | Tooling | Copilot App 中的 MCP 使用 | [ Guide ](./12-tooling/README.md) |
### 💻 Sample Code Projects
### 💻 示例代码项目
One of the most exciting parts of learning MCP is seeing your code skills develop progressively. We've designed our code examples to start simple and grow more sophisticated as your understanding deepens. Here's how we introduce concepts - with code that's easy to understand but demonstrates real MCP principles, you'll understand not just what this code does, but why it's structured this way and how it fits into larger MCP applications.
学习 MCP 最令人兴奋的部分之一,就是见证自己的编程能力逐步提升。我们设计的代码示例从简单入手,并随着你对 MCP 理解的加深而愈发完善。以下是我们引入概念的方式——通过易于理解却能体现真实 MCP 原则的代码,你不仅能明白这段代码在做什么,还能理解它为何如此组织,以及它如何融入更大的 MCP 应用。
#### Basic MCP Calculator Samples
#### 基础 MCP 计算器示例
| Language | Description | Link |
|----------|-------------|------|
@@ -230,7 +236,7 @@ One of the most exciting parts of learning MCP is seeing your code skills develo
| TypeScript | MCP Example | [View Code](./03-GettingStarted/samples/typescript/README.md) |
| Rust | MCP Example | [View Code](./03-GettingStarted/samples/rust/README.md) |
#### Advanced MCP Implementations
#### 高级 MCP 实现
| Language | Description | Link |
|----------|-------------|------|
@@ -241,119 +247,115 @@ One of the most exciting parts of learning MCP is seeing your code skills develo
| TypeScript | Container Sample | [View Code](./04-PracticalImplementation/samples/typescript/README.md) |
## 🎯 Prerequisites for Learning MCP
## 🎯 学习 MCP 的前置条件
To get the most out of this curriculum, you should have:
要充分利用本课程体系,你应具备:
- Basic knowledge of programming in at least one of the following languages: C#, Java, JavaScript, Python, or TypeScript
- Understanding of client-server model and APIs
- Familiarity with REST and HTTP concepts
- (Optional) Background in AI/ML concepts
- 至少掌握以下一门语言的基础编程知识:C#、JavaJavaScriptPython TypeScript
- 理解客户端-服务器(client-server)模型与 API
- 熟悉 REST HTTP 概念
- (可选)具备 AI/ML 相关背景
- Joining our community discussions for support
- 参与我们的社区讨论以获得支持
## 📚 Study Guide & Resources
## 📚 学习指南与资源
This repository includes several resources to help you navigate and learn effectively:
本仓库提供多项资源,帮助你高效浏览并学习:
### Study Guide
### 学习指南
A comprehensive [Study Guide](./study_guide.md) is available to help you navigate this repository effectively. This visual curriculum map shows how all the topics connect and provides guidance on how to use the sample projects effectively. It's especially helpful if you're a visual learner who likes to see the big picture.
我们提供了一份全面的[学习指南](./study_guide.md),帮助你高效浏览本仓库。这份可视化的课程地图展示了各主题之间的关联,并指导你如何有效使用示例项目。若你是喜欢先把握全局的视觉型学习者,它会特别有帮助。
The guide includes:
- A visual curriculum map showing all topics covered
- Detailed breakdown of each repository section
- Guidance on how to use sample projects
- Recommended learning paths for different skill levels
- Additional resources to complement your learning journey
该指南包括:
- 展示所有涵盖主题的可视化课程地图
- 各仓库章节的详细拆解
- 如何使用示例项目的指导
- 面向不同技能水平的推荐学习路径
- 补充你学习之旅的额外资源
### Changelog
### 更新日志
We maintain a detailed [Changelog](./changelog.md) that tracks all significant updates to the curriculum materials, so you can stay current with the latest improvements and additions.
- New content additions
- Structural changes
- Feature improvements
- Documentation updates
我们维护一份详细的[更新日志](./changelog.md),记录课程体系材料的所有重要更新,便于你及时了解最新改进与新增内容。
- 新增内容
- 结构调整
- 功能改进
- 文档更新
## 🛠️ How to Use This Curriculum Effectively
## 🛠️ 如何有效使用本课程体系
Each lesson in this guide includes:
本指南中的每节课都包含:
1. Clear explanations of MCP concepts
2. Live code examples in multiple languages
3. Exercises to build real MCP applications
4. Extra resources for advanced learners
1. 对 MCP 概念的清晰讲解
2. 多种语言的实时代码示例
3. 用于构建真实 MCP 应用的练习
4. 面向进阶学习者的额外资源
### Let's Learn MCP with C# - Tutorial Series
Let's learn about the Model Context Protocol (MCP), a cutting-edge framework designed to standardize interactions between AI models and client applications. Through this beginner-friendly session, we'll introduce you to MCP and guide you through creating your first MCP server.
### 用 C# 学习 MCP——教程系列
让我们了解模型上下文协议(Model Context ProtocolMCP)——一个旨在标准化 AI 模型与客户端应用之间交互的前沿框架。通过这场对初学者友好的课程,我们将向你介绍 MCP,并引导你创建第一个 MCP 服务器。
#### C#: [https://aka.ms/letslearnmcp-csharp](https://aka.ms/letslearnmcp-csharp)
#### Java: [https://aka.ms/letslearnmcp-java](https://aka.ms/letslearnmcp-java)
#### JavaScript: [https://aka.ms/letslearnmcp-javascript](https://aka.ms/letslearnmcp-javascript)
#### Python: [https://aka.ms/letslearnmcp-python](https://aka.ms/letslearnmcp-python)
## 🎓 Your MCP Journey Begins
## 🎓 你的 MCP 之旅从这里开始
Congratulations! You've just taken the first step in an exciting journey that will expand your programming capabilities and connect you to the cutting edge of AI development.
恭喜!你刚刚迈出了激动人心旅程的第一步;它将拓展你的编程能力,并让你与 AI 开发的前沿紧密相连。
### What You've Already Accomplished
### 你已经取得的进展
By reading through this introduction, you've already begun building your MCP knowledge foundation. You understand what MCP is, why it matters, and how this curriculum will support your learning journey. That's a significant achievement and the beginning of your expertise in this important technology.
通读本介绍后,你已经开始搭建 MCP 知识基础。你理解了 MCP 是什么、它为何重要,以及本课程体系将如何支持你的学习之旅。这是一项重要成就,也是你在这一关键技术领域积累专业能力的起点。
### The Adventure Ahead
### 前方的探索
As you progress through the modules, remember that every expert was once a beginner. The concepts that might seem complex now will become second nature as you practice and apply them. Each small step builds toward powerful capabilities that will serve you throughout your development career.
随着你逐步完成各模块,请记住:每位专家都曾是初学者。如今看似复杂的概念,会在你不断练习与应用后变得得心应手。每一个小步都会汇聚成强大的能力,并在你的开发生涯中持续发挥作用。
### Your Support Network
### 你的支持网络
You're joining a community of learners and experts who are passionate about MCP and eager to help others succeed. Whether you're stuck on a coding challenge or excited to share a breakthrough, the community is here to support your journey.
你将加入一个由学习者和专家组成的社区;他们热爱 MCP,并乐于帮助他人成功。无论你卡在编码难题上,还是兴奋地想要分享突破,社区都会支持你的旅程。
If you get stuck or have any questions about building AI apps. Join fellow learners and experienced developers in discussions about MCP. It's a supportive community where questions are welcome and knowledge is shared freely.
如果你在构建 AI 应用时遇到困难,或对任何问题存有疑问,可与同伴学习者和经验丰富的开发者一起讨论 MCP。这是一个友善的社区:欢迎提问,知识自由分享。
[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG)
If you have product feedback or errors while building visit:
如果你在构建过程中有产品反馈或发现错误,请访问:
[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum)
### Ready to Begin?
### 准备好开始了吗?
Your MCP adventure starts now! Begin with Module 0 to dive into your first hands-on MCP experiences, or explore the sample projects to see what you'll be building. Remember - every expert started exactly where you are now, and with patience and practice, you'll be amazed at what you can achieve.
你的 MCP 冒险现在开始!从模块 0 开始,进入你的第一次 MCP 动手实践;或浏览示例项目,看看你将构建什么。请记住——每位专家都曾站在你现在的位置;凭借耐心与练习,你会对自己能取得的成就感到惊喜。
Welcome to the world of Model Context Protocol development. Let's build something amazing together!
欢迎来到模型上下文协议(Model Context Protocol)开发的世界。让我们一起构建精彩的作品!
## 🤝 Contributing to the Learning Community
## 🤝 为学习社区做贡献
This curriculum grows stronger with contributions from learners like you! Whether you're fixing a typo, suggesting a clearer explanation, or adding a new example, your contributions help other beginners succeed.
本课程体系会因像你这样的学习者贡献而更加完善!无论你是修正笔误、提出更清晰的表述,还是新增示例,你的贡献都能帮助其他初学者成功。
Thanks to Microsoft Valued Professional [Shivam Goyal](https://www.linkedin.com/in/shivam2003/) for contributing code samples.
感谢 Microsoft 最有价值专家(Most Valuable Professional[Shivam Goyal](https://www.linkedin.com/in/shivam2003/) 贡献代码示例。
The contribution process is designed to be welcoming and supportive. Most contributions require a Contributor License Agreement (CLA), but the automated tools will guide you through the process smoothly.
贡献流程旨在友好且易于上手。大多数贡献需要签署贡献者许可协议(Contributor License AgreementCLA),但自动化工具会顺畅地引导你完成流程。
## 📜 Open Source Learning
## 📜 开源学习
This entire curriculum is available under the MIT [LICENSE](./LICENSE), meaning you can use, modify, and share it freely. This supports our mission of making MCP knowledge accessible to developers everywhere.
## 🤝 Contribution Guidelines
整套课程体系均在 MIT [LICENSE](./LICENSE) 许可下提供,这意味着你可以自由使用、修改和分享。这支持我们让 MCP 知识惠及全球开发者的使命。
## 🤝 贡献指南
This project welcomes contributions and suggestions. Most contributions require you to agree to a
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
the rights to use your contribution. For details, visit <https://cla.opensource.microsoft.com>.
本项目欢迎贡献与建议。大多数贡献要求你同意贡献者许可协议(Contributor License AgreementCLA),声明你有权且确实授予我们使用你贡献内容的权利。详情请访问 <https://cla.opensource.microsoft.com>。
When you submit a pull request, a CLA bot will automatically determine whether you need to provide
a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
provided by the bot. You will only need to do this once across all repos using our CLA.
当你提交拉取请求(pull request)时,CLA 机器人会自动判断你是否需要提供 CLA,并相应地标注 PR(例如状态检查、评论)。只需按照机器人提供的说明操作即可。在我们使用 CLA 的所有仓库中,你只需完成一次该流程。
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
本项目已采用 [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
更多信息请参阅 [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
联系 [opencode@microsoft.com](mailto:opencode@microsoft.com) 提出任何其他问题或意见。
---
*Ready to start your MCP journey? Begin with [Module 00 - Introduction to MCP](./00-Introduction/README.md) and take your first steps into the world of Model Context Protocol development!*
*准备好开启你的 MCP 之旅了吗?从 [Module 00 - Introduction to MCP](./00-Introduction/README.md) 开始,迈出进入 Model Context Protocol(模型上下文协议)开发世界的第一步!*
## 🎒 Other Courses
Our team produces other courses! Check out:
## 🎒 其他课程
我们团队还制作了其他课程!快来看看:
<!-- CO-OP TRANSLATOR OTHER COURSES START -->
### LangChain
@@ -370,7 +372,7 @@ Our team produces other courses! Check out:
---
### Generative AI Series
### 生成式 AI 系列
[![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst)
[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst)
[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst)
@@ -378,7 +380,7 @@ Our team produces other courses! Check out:
---
### Core Learning
### 核心学习
[![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst)
[![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst)
[![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst)
@@ -389,7 +391,7 @@ Our team produces other courses! Check out:
---
### Copilot Series
### Copilot 系列
[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst)
[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst)
[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst)