Skip to content

Commit fe93597

Browse files
burtenshawburtenshaw
committed
first draft
1 parent c13844e commit fe93597

21 files changed

+1322
-0
lines changed

‎.github/workflows/build_documentation.yml‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
name: Build documentation
2+
3+
on:
4+
push:
5+
branches:
6+
- main
7+
workflow_dispatch:
8+
9+
jobs:
10+
build:
11+
uses: huggingface/doc-builder/.github/workflows/build_main_documentation.yml@main
12+
with:
13+
commit_sha: ${{ github.sha }}
14+
package: mcp-course
15+
path_to_docs: units
16+
build_command: doc-builder build mcp-course units --build_dir build/mcp-course
17+
deploy_to_hub: true
18+
languages: en

‎.github/workflows/build_pr_documentation.yml‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
name: Build PR Documentation
2+
3+
on:
4+
pull_request:
5+
6+
concurrency:
7+
group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
8+
cancel-in-progress: true
9+
10+
jobs:
11+
build:
12+
uses: huggingface/doc-builder/.github/workflows/build_pr_documentation.yml@main
13+
with:
14+
commit_sha: ${{ github.event.pull_request.head.sha }}
15+
pr_number: ${{ github.event.number }}
16+
package: mcp-course
17+
path_to_docs: units
18+
additional_args: --not_python_module
19+
languages: en

‎README.md‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# The Model Context Protocol (MCP) Course
2+
3+
If you like the course, **don't hesitate to ⭐ star this repository**. This helps us to **make the course more visible 🤗**.
4+
5+
## Content
6+
7+
The course is divided into 4 units. These will take you from **the basics of Model Context Protocol to a final project implementing MCP in an AI application**.
8+
9+
Sign up here (it's free) 👉 [Coming Soon]
10+
11+
You can access the course here 👉 [Coming Soon]
12+
13+
| Unit | Topic | Description |
14+
| ------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
15+
| 0 | Welcome to the Course | Welcome, guidelines, necessary tools, and course overview. |
16+
| 1 | Introduction to Model Context Protocol | Definition of MCP, key concepts, and its role in connecting AI models with external data and tools. |
17+
| 2 | Understanding MCP Architecture and Core Concepts | Explore the MCP architecture, communication protocols, and core primitives. |
18+
| 3 | Building with MCP: Practical Development | Learn to implement MCP clients and servers using available SDKs and frameworks. |
19+
| 4 | Advanced Topics, Security, and the Future of MCP | Explore advanced features, security considerations, and the future roadmap of MCP. |
20+
21+
## Prerequisites
22+
23+
* Basic understanding of AI and LLM concepts
24+
* Familiarity with software development principles and API concepts
25+
* Experience with at least one programming language (Python or TypeScript examples will be emphasized)
26+
27+
## Contribution Guidelines
28+
29+
If you want to contribute to this course, you're welcome to do so. Feel free to open an issue or submit a pull request. For specific contributions, here are some guidelines:
30+
31+
### Small typo and grammar fixes
32+
33+
If you find a small typo or grammar mistake, please fix it yourself and submit a pull request. This is very helpful for students.
34+
35+
### New unit
36+
37+
If you want to add a new unit, **please create an issue in the repository, describe the unit, and why it should be added**. We will discuss it and if it's a good addition, we can collaborate on it.
38+
39+
## Citing the project
40+
41+
To cite this repository in publications:
42+
43+
```
44+
@misc{mcp-course,
45+
author = {Your Name},
46+
title = {The Model Context Protocol Course},
47+
year = {2025},
48+
howpublished = {\url{https://github.com/yourusername/mcp-course}},
49+
note = {GitHub repository},
50+
}
51+
```

‎requirements.txt‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
hf-doc-builder>=0.5.0
2+
mdx_truly_sane_lists
3+
pyyaml

‎units/en/_toctree.yml‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
- title: "0. Welcome to the MCP Course"
2+
sections:
3+
- local: unit0/introduction
4+
title: Welcome to the MCP Course
5+
6+
- title: "1. Introduction to Model Context Protocol"
7+
sections:
8+
- local: unit1/introduction
9+
title: Introduction to Model Context Protocol (MCP)
10+
- local: unit1/what-is-mcp
11+
title: What is Model Context Protocol (MCP)?
12+
- local: unit1/key-concepts
13+
title: Key Concepts and Terminology
14+
- local: unit1/quiz1
15+
title: Unit 1 Quiz
16+
17+
- title: "2. Understanding MCP Architecture and Core Concepts"
18+
sections:
19+
- local: unit2/introduction
20+
title: Understanding MCP Architecture and Core Concepts
21+
- local: unit2/architectural-components
22+
title: Architectural Components
23+
- local: unit2/communication-protocol
24+
title: The Communication Protocol
25+
- local: unit2/capabilities
26+
title: Understanding MCP Capabilities
27+
- local: unit2/quiz2
28+
title: Unit 2 Quiz
29+
30+
- title: "3. Building with MCP: Practical Development"
31+
sections:
32+
- local: unit3/introduction
33+
title: Introduction
34+
- local: unit3/environment-setup
35+
title: Setting Up Your Development Environment & SDKs
36+
- local: unit3/building-server
37+
title: Building Your First MCP Server
38+
- local: unit3/server-capabilities
39+
title: Implementing Server Capabilities
40+
- local: unit3/developing-clients
41+
title: Developing MCP Clients
42+
- local: unit3/configuration
43+
title: Configuration, Authentication, and Debugging
44+
- local: unit3/mcp-ecosystem
45+
title: Navigating the MCP Ecosystem
46+
- local: unit3/gradio-mcp
47+
title: "Hugging Face Gradio MCP Integration"
48+
- local: unit3/hub-mcp-servers
49+
title: "Working with MCP Servers on Hugging Face Hub"
50+
- local: unit3/tiny-agents-mcp
51+
title: "Building with Tiny Agents and MCP"
52+
- local: unit3/practical-exercise
53+
title: "Practical Exercise: MCP Interaction Walkthrough"
54+
- local: unit3/quiz
55+
title: Unit 3 Quiz
56+
57+
- title: "4. Advanced Topics, Security, and the Future of MCP"
58+
sections:
59+
- local: unit4/introduction
60+
title: Introduction
61+
- local: unit4/advanced-features
62+
title: Exploring Advanced MCP Features
63+
- local: unit4/security
64+
title: Security Deep Dive - Threats and Mitigation Strategies
65+
- local: unit4/limitations
66+
title: Limitations, Challenges, and Comparisons
67+
- local: unit4/huggingface-ecosystem
68+
title: Hugging Face's Ecosystem and Future Contributions
69+
- local: unit4/future
70+
title: The Future of MCP - Roadmap and Standardization
71+
- local: unit4/final-project
72+
title: Final Project - Building a Complete MCP Application
73+
- local: unit4/certification
74+
title: Certification and Next Steps

‎units/en/unit0/_toctree.yml‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
- title: 0. Setup
2+
sections:
3+
- local: unit0/introduction
4+
title: Welcome to the MCP Course
5+
- local: unit0/onboarding
6+
title: 🤗 Onboarding (Optional)
7+
- local: unit0/discord
8+
title: Discord 101
9+
10+
- title: Live Session 1
11+
sections:
12+
- local: unit0/livesession1
13+
title: How the course works and Q&A

‎units/en/unit0/introduction.mdx‎

Lines changed: 153 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,153 @@
1+
# Welcome to the 🤗 Model Context Protocol (MCP) Course
2+
3+
![MCP Course thumbnail](https://placeholder-for-mcp-course-thumbnail.com/image.png)
4+
5+
Welcome to the most exciting topic in AI today: **Model Context Protocol (MCP)**!
6+
7+
This free course will take you on a journey, **from beginner to expert**, in understanding, using, and building applications with MCP.
8+
9+
This first unit will help you onboard:
10+
11+
* Discover the **course's syllabus**.
12+
* **Choose the path** you're going to take (either self-audit or certification process).
13+
* **Get more information about the certification process and the deadlines**.
14+
* Get to know the team behind the course.
15+
* Create your **account**.
16+
* **Sign-up to our Discord server**, and meet your classmates and us.
17+
18+
Let's get started!
19+
20+
## What to expect from this course?
21+
22+
In this course, you will:
23+
24+
* 📖 Study Model Context Protocol in **theory, design, and practice.**
25+
* 🧑‍💻 Learn to **use established MCP SDKs and frameworks**.
26+
* 💾 **Share your projects** and explore applications created by the community.
27+
* 🏆 Participate in challenges where you will **evaluate your MCP implementations against other students'.**
28+
* 🎓 **Earn a certificate of completion** by completing assignments.
29+
30+
And more!
31+
32+
At the end of this course, you'll understand **how MCP works and how to build your own AI applications that leverage external data and tools using the latest MCP standards**.
33+
34+
Don't forget to **sign up to the course!**
35+
36+
(We are respectful of your privacy. We collect your email address to be able to **send you the links when each Unit is published and give you information about the challenges and updates**).
37+
38+
## What does the course look like?
39+
40+
The course is composed of:
41+
42+
* _Foundational Units_: where you learn MCP **concepts in theory**.
43+
* _Hands-on_: where you'll learn **to use established MCP SDKs** to build your applications. These hands-on sections will have pre-configured environments.
44+
* _Use case assignments_: where you'll apply the concepts you've learned to solve a real-world problem that you'll choose.
45+
* _The Challenge_: you'll get to put your implementation to compete against other implementations in a challenge. There will also be a leaderboard for you to compare performance.
46+
47+
This **course is a living project, evolving with your feedback and contributions!** Feel free to open issues and PRs in GitHub, and engage in discussions in our Discord server.
48+
49+
After you have gone through the course, you can also send your feedback 👉 using this form [LINK TO FEEDBACK FORM]
50+
51+
## What's the syllabus?
52+
53+
Here is the **general syllabus for the course**. A more detailed list of topics will be released with each unit.
54+
55+
| Chapter | Topic | Description |
56+
| ------- | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
57+
| 0 | Onboarding | Set you up with the tools and platforms that you will use. |
58+
| 1 | MCP Fundamentals | Explain core concepts, architecture, and components of Model Context Protocol. Show a simple use case using MCP. |
59+
| 2 | Architecture and Core Concepts | Understand the MCP architecture, communication protocols, and core primitives like Tools, Resources, and Prompts. |
60+
| 3 | Practical Development | Learn to implement MCP clients and servers using available SDKs and frameworks. |
61+
| 4 | Advanced Topics and Security | Explore advanced features, security considerations, and the future roadmap of MCP. |
62+
63+
## What are the prerequisites?
64+
65+
To be able to follow this course, you should have:
66+
67+
* Basic understanding of AI and LLM concepts
68+
* Familiarity with software development principles and API concepts
69+
* Experience with at least one programming language (Python or TypeScript examples will be emphasized)
70+
71+
## What tools do I need?
72+
73+
You only need 2 things:
74+
75+
* _A computer_ with an internet connection.
76+
* An _Account_: to access the course resources and create projects. If you don't have an account yet, you can create one **here** (it's free).
77+
78+
## The Certification Process
79+
80+
### Two paths
81+
82+
You can choose to follow this course _in audit mode_, or do the activities and _get one of the two certificates we'll issue_.
83+
84+
If you audit the course, you can participate in all the challenges and do assignments if you want, and **you don't need to notify us**.
85+
86+
The certification process is **completely free**:
87+
88+
* _To get a certification for fundamentals_: you need to complete Unit 1 of the course. This is intended for students that want to get up to date with the latest trends in MCP.
89+
* _To get a certificate of completion_: you need to complete Unit 1, one of the use case assignments we'll propose during the course, and the final challenge.
90+
91+
There's a deadline for the certification process: all the assignments must be finished before **July 1st 2025**.
92+
93+
![Deadline](https://placeholder-for-deadline-image.com/image.png)
94+
95+
## What is the recommended pace?
96+
97+
Each chapter in this course is designed **to be completed in 1 week, with approximately 3-4 hours of work per week**.
98+
99+
Since there's a deadline, we provide you a recommended pace:
100+
101+
![Recommended Pace](https://placeholder-for-pace-image.com/image.png)
102+
103+
## How to get the most out of the course?
104+
105+
To get the most out of the course, we have some advice:
106+
107+
1. Join study groups in Discord: studying in groups is always easier. To do that, you need to join our discord server and verify your account.
108+
2. **Do the quizzes and assignments**: the best way to learn is through hands-on practice and self-assessment.
109+
3. **Define a schedule to stay in sync**: you can use our recommended pace schedule below or create yours.
110+
111+
![Course advice](https://placeholder-for-advice-image.com/image.png)
112+
113+
## Who are we
114+
115+
About the authors:
116+
117+
### Author 1
118+
119+
Author 1 is an AI engineer and has built and deployed MCP applications in production. Author 1 will be your main instructor for this course.
120+
121+
* Follow Author 1 on GitHub
122+
* Follow Author 1 on Twitter
123+
* Follow Author 1 on LinkedIn
124+
125+
### Author 2
126+
127+
Author 2 is an AI engineer and has delivered multiple courses across various platforms. Author 2's goal is to make the course accessible to everyone.
128+
129+
* Follow Author 2 on GitHub
130+
* Follow Author 2 on Twitter
131+
* Follow Author 2 on LinkedIn
132+
133+
## Acknowledgments
134+
135+
We would like to extend our gratitude to the following individuals for their invaluable contributions to this course:
136+
137+
* **Contributor 1** – For guidance and expertise in reviewing the materials.
138+
* **Contributor 2** – For amazing demo applications.
139+
* **Contributor 3** – For help on the course content.
140+
141+
## I found a bug, or I want to improve the course
142+
143+
Contributions are **welcome** 🤗
144+
145+
* If you _found a bug 🐛 in a notebook_, please open an issue and **describe the problem**.
146+
* If you _want to improve the course_, you can open a Pull Request.
147+
* If you _want to add a full section or a new unit_, the best is to open an issue and **describe what content you want to add before starting to write it so that we can guide you**.
148+
149+
## I still have questions
150+
151+
Please ask your question in our discord server #mcp-course-questions.
152+
153+
Now that you have all the information, let's get on board ⛵

‎units/en/unit1/_toctree.yml‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
- title: 1. Introduction to Model Context Protocol
2+
sections:
3+
- local: unit1/introduction
4+
title: Introduction
5+
- local: unit1/what-is-mcp
6+
title: What is Model Context Protocol?
7+
- local: unit1/quiz1
8+
title: Quick Quiz 1
9+
- local: unit1/key-concepts
10+
title: Key Concepts of Model Context Protocol
11+
- local: unit1/integration-challenges
12+
title: The Integration Challenges MCP Solves
13+
- local: unit1/quiz2
14+
title: Quick Quiz 2
15+
- local: unit1/benefits-goals
16+
title: Key Benefits and Goals of MCP
17+
- local: unit1/example-project
18+
title: A Simple MCP Integration Example
19+
- local: unit1/finalquiz
20+
title: Unit 1 Final Quiz

0 commit comments

Comments
 (0)