Skip to content

[TRANSLATION] Translation to Chinese #18

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 46 additions & 0 deletions units/zh_CN/_toctree.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
- title: "0. MCP 课程欢迎页"
sections:
- local: unit0/introduction
title: 欢迎来到 MCP 课程

- title: "1. Model Context Protocol 介绍"
sections:
- local: unit1/introduction
title: Model Context Protocol (MCP) 介绍
- local: unit1/key-concepts
title: 关键概念与术语
- local: unit1/architectural-components
title: 架构组件
- local: unit1/communication-protocol
title: 通信协议
- local: unit1/capabilities
title: MCP 能力解析
- local: unit1/sdk
title: MCP SDK
- local: unit1/mcp-clients
title: MCP 客户端
- local: unit1/gradio-mcp
title: Gradio MCP 集成

- title: "2. 用例:端到端 MCP 应用"
sections:
- local: unit2/introduction
title: MCP 应用构建入门
- local: unit2/gradio-server
title: 构建 Gradio MCP 服务端
- local: unit2/clients
title: 在应用中使用 MCP 客户端
- local: unit2/gradio-client
title: 使用 Gradio 构建 MCP 客户端
- local: unit2/tiny-agents
title: 使用 TypeScript 构建微型智能体

- title: "3. 用例:高级 MCP 开发"
sections:
- local: unit3/introduction
title: 即将推出

- title: "附加单元"
sections:
- local: unit4/introduction
title: 即将推出
104 changes: 104 additions & 0 deletions units/zh_CN/unit0/introduction.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
# 欢迎来到 🤗 模型上下文协议 (MCP) 课程

![MCP 课程封面](https://huggingface.co/datasets/mcp-course/images/resolve/main/unit0/1.png)

欢迎来到当今 AI 领域最激动人心的主题:**模型上下文协议(Model Context Protocol,MCP)**!

本免费课程将带你从零基础到精通,全面掌握 MCP 的理解、使用和应用开发。

本单元将帮助你快速入门:
* 查看**课程大纲**
* **获取证书获取流程与时间表**的详细信息
* 认识课程开发团队
* 创建你的**账户**
* **加入我们的 Discord 服务器**,与同学和导师互动

让我们开始吧!

## 课程内容概览

在本课程中你将:
* 📖 学习 MCP 的**理论、设计与实践**
* 🧑‍💻 掌握**使用主流 MCP SDK 和框架**
* 💾 **分享你的项目**并探索社区作品
* 🏆 参与挑战赛,**与其他学员的 MCP 实现方案同台竞技**
* 🎓 完成作业**获取结业证书**

课程结束后,你将掌握**如何运用 MCP 标准构建接入外部数据和工具的 AI 应用**。

别忘了[**立即报名课程!**](https://huggingface.co/mcp-course)

## 课程结构
课程包含:
* _基础单元_:学习 MCP **核心理论**
* _实践环节_:使用**预配置环境**和主流 MCP SDK 构建应用
* _案例作业_:应用所学知识解决真实场景问题
* _合作项目_:与 Hugging Face 合作伙伴共同探索最新 MCP 工具

**本课程将持续演进,期待你的反馈与贡献!** 欢迎在 GitHub 提交 issue/PR,或在 Discord 参与讨论。

课程结束后可通过[反馈表](LINK TO FEEDBACK FORM)提交建议 👈

## 课程大纲
以下是课程总体大纲,各单元详细主题将随课程发布:

| 章节 | 主题 | 描述 |
| ---- | ----------------------------------------- | --------------------------------------------------------------------------------------- |
| 0 | 入门指南 | 配置开发环境与学习平台 |
| 1 | MCP 基础、架构与核心概念 | 解析 MCP 核心概念与架构组件,演示基础用例 |
| 2 | 端到端案例:MCP 实战 | 构建可分享的完整 MCP 应用 |
| 3 | 部署案例:MCP 实战 | 使用 Hugging Face 生态与合作伙伴服务部署 MCP 应用 |
| 4 | 附加单元 | 与合作伙伴共同打造的拓展内容 |

## 先修要求
建议具备:
* AI 和 LLM 基础概念理解
* 软件开发与 API 基础认知
* 至少掌握一门编程语言(课程示例使用 Python/TypeScript)

如需补充知识:
* [LLM 课程](https://huggingface.co/learn/llm-course/):LLM 基础与应用
* [智能体课程](https://huggingface.co/learn/agents-course/):LLM 智能体开发

<Tip>
以上课程非强制先修,只要理解 LLM 和智能体概念即可立即开始!
</Tip>

## 所需工具
仅需:
* 可联网的_电脑_
* Hugging Face _账户_([免费注册](https://huggingface.co/join))

## 证书获取
两种学习模式:
* _旁听模式_:可参与所有活动(无需证书)
* _认证模式_(完全免费):
- **基础证书**:完成单元 1(适合了解 MCP 最新趋势)
- **结业证书**:完成单元 2-3(需构建完整应用)

## 学习进度建议
每周投入 3-4 小时,1 周完成 1 个章节:

![推荐进度](https://huggingface.co/datasets/mcp-course/images/resolve/main/unit0/2.png)

## 高效学习建议
1. 加入 Discord 学习小组
2. **完成测验与作业**
3. **制定学习计划**

![学习建议](https://huggingface.co/datasets/mcp-course/images/resolve/main/unit0/3.png)

## 课程团队
### Ben Burtenshaw
Hugging Face 机器学习工程师,专注于 LLM 应用开发与智能体技术

## 问题反馈
欢迎贡献 🤗
* 提交 bug:GitHub 创建 issue
* 改进课程:提交 Pull Request
* 新增内容:先创建 issue 讨论方案

## 其他问题
请至 Discord 的 #mcp-course-questions 频道提问

准备好启航了吗?⛵
85 changes: 85 additions & 0 deletions units/zh_CN/unit1/architectural-components.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
# MCP 的架构组件

在上一节中,我们讨论了 MCP 的核心概念和术语。现在让我们深入探讨构成 MCP 生态系统的架构组件。

## Host、Client 和 Server

模型上下文协议(Model Context Protocol,MCP)基于客户端-服务端架构构建,实现 AI 模型与外部系统的结构化通信。

![MCP 架构示意图](https://huggingface.co/datasets/mcp-course/images/resolve/main/unit1/4.png)

MCP 架构包含三个主要组件,每个组件都有明确的职责划分:

### Host(宿主)

**Host** 是直接面向用户的 AI 应用程序。典型示例包括:
- AI 聊天应用(如 OpenAI ChatGPT 或 Anthropic 的 Claude Desktop)
- 增强型 IDE(如 Cursor)或工具集成(如 Continue.dev)
- 使用 LangChain 或 smolagents 构建的自定义智能体

Host 的核心职责:
- 管理用户交互与权限控制
- 通过 MCP Client 建立与 Server 的连接
- 协调用户请求、LLM 处理与外部工具的整体流程
- 以可理解格式呈现结果

开发者可能选择 Cursor 作为开发工具,而领域专家可能使用 smolagents 构建定制应用。

### Client(客户端)

**Client** 是 Host 应用中负责与特定 Server 通信的组件,特点包括:
- 与单个 Server 保持 1:1 连接
- 处理 MCP 协议层通信细节
- 作为 Host 逻辑与外部 Server 的中介

### Server(服务端)

**Server** 是通过 MCP 协议对外提供能力的程序/服务,特点包括:
- 封装特定外部工具、数据源或服务
- 可作为现有功能的轻量级封装层
- 支持本地或远程部署
- 以标准化格式暴露可发现的能力

## 通信流程

典型 MCP 工作流包含以下步骤:

<Tip>
下一节将通过实际案例深入解析通信协议细节
</Tip>

1. **用户交互**:用户与 Host 应用进行交互
2. **请求处理**:Host 解析用户输入(可能使用 LLM)
3. **建立连接**:Host 指示 Client 连接目标 Server
4. **能力发现**:Client 查询 Server 可用能力(工具/资源/提示词)
5. **调用能力**:根据需求调用 Server 特定能力
6. **执行返回**:Server 执行操作并返回结果
7. **结果整合**:Client 将结果传回 Host 进行后续处理

架构优势在于模块化设计:
- 单个 Host 可通过多个 Client 连接不同 Server
- 新增 Server 无需修改现有 Host
- 跨 Server 能力可自由组合

<Tip>
这种设计将传统的 M×N 集成问题转化为 M+N 问题,各组件只需实现一次 MCP 标准
</Tip>

## 架构优势

该架构的核心价值在于:
- **协议标准化**:统一通信规范
- **职责分离**:明确组件边界
- **生态扩展性**:支持无缝接入新工具和数据源

## 设计原则

MCP 遵循以下核心原则:
- **标准化**:提供通用 AI 连接协议
- **简洁性**:保持核心协议简单直观
- **安全性**:敏感操作需显式用户授权
- **可发现性**:支持动态能力探测
- **可扩展性**:通过版本协商支持演进
- **互操作性**:确保跨实现环境的兼容性

下一节我们将深入解析实现这些组件协作的通信协议细节。
Loading