模型上下文协议（MCP）课程

如果你喜欢这门课程，请不要犹豫，为本仓库点个⭐星。这将帮助我们 让课程更加显眼 🤗。

课程内容

本课程共分为4个单元，将带你从 模型上下文协议的基础知识，逐步深入到在AI应用中实现MCP的最终项目。

立即注册（免费）👉 [即将上线]

你可在此访问课程 👉 [即将上线]

单元	主题	描述
0	课程欢迎页	欢迎词、学习指南、所需工具及课程概览。
1	模型上下文协议简介	MCP的定义、关键概念及其在连接AI模型与外部数据和工具中的作用。
2	使用MCP进行开发：实践篇	学习如何使用现有的SDK和框架来实现MCP客户端和服务器。
3	MCP协议深度解析	探索MCP的高级特性、架构以及实际应用场景中的集成模式
4	附加单元与合作	特别主题、合作伙伴库以及社区驱动的项目。

先修条件

• 对AI和LLM的基本概念有一定了解
• 熟悉软件开发原则和API相关概念
• 至少掌握一门编程语言（课程将以Python或TypeScript为例进行讲解）

贡献指南

如果你想为本课程贡献力量，我们非常欢迎！请随时提交问题或拉取请求。针对不同类型的贡献，以下是具体指南：

小错误修正与语法调整

如果你发现小的拼写或语法错误，请自行修改并提交拉取请求。这对学员们非常有帮助。

新增单元

如果你想新增一个单元，请先在仓库中创建一个问题，详细描述该单元的内容及其加入的理由。我们会进行讨论，若认为合适，便可共同协作完成。

引用本项目

如需在出版物中引用本仓库，请使用以下格式：

@misc{mcp-course,
  author = {Burtenshaw, Ben and Notov, Alex},
  title = {模型上下文协议课程},
  year = {2025},
  howpublished = {\url{https://github.com/huggingface/mcp-course}},
  note = {GitHub代码库},
}

mcp-course 快速上手指南

本指南旨在帮助中国开发者快速了解并开始学习 Model Context Protocol (MCP) 开源课程。该课程将带你从 MCP 基础概念进阶到在实际 AI 应用中实现 MCP 的完整项目。

环境准备

在开始本课程之前，请确保你的开发环境满足以下要求：

系统要求

• 操作系统：Windows, macOS 或 Linux
• 网络环境：能够访问 GitHub 及 Hugging Face（如需下载相关资源）

前置依赖

• 基础知识：
  • 对人工智能 (AI) 和大语言模型 (LLM) 概念有基本理解。
  • 熟悉软件开发原则及 API 相关概念。
• 编程能力：
  • 至少掌握一门编程语言。本课程示例主要使用 Python 或 TypeScript。
• 开发工具：
  • 已安装对应语言的运行环境（Python 3.x 或 Node.js）。
  • 代码编辑器（如 VS Code）。

注意：目前课程注册页面和正式学习内容显示为 "Coming Soon"（即将上线），请先完成环境配置并关注仓库更新以获取最新课程链接。

安装步骤

由于这是一个在线课程仓库，无需安装复杂的二进制软件。你只需要克隆仓库以获取学习资料和示例代码。

1. 克隆仓库 打开终端，执行以下命令将课程代码下载到本地：

   git clone https://github.com/huggingface/mcp-course.git
   

2. 进入目录

   cd mcp-course
   

3. 安装示例依赖（可选） 根据后续具体单元（Unit 2 及以后）的示例代码需求，你可能需要安装 Python 或 TypeScript 的相关 SDK。请参考各单元目录下的 requirements.txt 或 package.json 进行安装。

   Python 示例:

   pip install -r requirements.txt
   

   (注：若在国内安装较慢，可配置国内镜像源，例如：pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple)

   TypeScript 示例:

   npm install
   

   (注：若在国内安装较慢，可配置国内镜像源，例如：npm config set registry https://registry.npmmirror.com)

基本使用

本课程分为 5 个单元（Unit 0 - Unit 4），学习路径如下：

1. 浏览课程结构 在本地或 GitHub 网页上查看 README.md 中的目录结构，了解各单元主题：

   • Unit 0: 课程欢迎页、指南及工具概览。
   • Unit 1: MCP 介绍（定义、核心概念、连接 AI 与外部数据的作用）。
   • Unit 2: 实战开发（使用 SDK 构建 MCP 客户端和服务端）。
   • Unit 3: 协议深入（高级特性、架构及真实集成模式）。
   • Unit 4: bonus 单元与社区协作项目。

2. 开始学习 由于在线课程平台链接暂未开放（显示为 Coming Soon），目前的最佳实践是：

   • 阅读仓库中已有的 Markdown 文档资料。
   • 关注仓库的 Issues 和 Releases 以获取课程上线通知。
   • 一旦课程链接开放，点击 README 中的 "You can access the course here" 链接即可免费注册并开始学习。

3. 参与贡献 如果你发现文档中有拼写错误或希望新增单元：

   • 小修正：直接修复并提交 Pull Request。
   • 新内容：请先创建一个 Issue，描述新单元的内容及其必要性，待讨论通过后再进行协作开发。

---

引用本项目:

@misc{mcp-course,
  author = {Burtenshaw, Ben and Notov, Alex},
  title = {The Model Context Protocol Course},
  year = {2025},
  howpublished = {\url{https://github.com/huggingface/mcp-course}},
  note = {GitHub repository},
}