Merge branch 'main' into pr/50

Author: burtenshaw

.github/workflows/build_documentation.yml

@@ -14,6 +14,6 @@ jobs:
       package_name: mcp-course
       path_to_docs: mcp-course/units/
       additional_args: --not_python_module
-      languages: en   
+      languages: en
     secrets:
-      hf_token: ${{ secrets.HF_DOC_BUILD_PUSH }}
+      hf_token: ${{ secrets.HF_DOC_BUILD_PUSH }}

.gitignore

@@ -172,3 +172,5 @@ cython_debug/
 
 # PyPI configuration file
 .pypirc
+
+.DS_Store

README.md

@@ -1,5 +1,7 @@
 # The Model Context Protocol (MCP) Course
 
+<div align="center"> <a href="README.md">🇺🇸 English</a> | <a href="README_vi.md">🇻🇳 Tiếng Việt</a> </div>
+
 ![1](https://github.com/user-attachments/assets/d26dcc5e-46cb-449e-aecb-49ece10d342a)
 
 If you like the course, **don't hesitate to ⭐ star this repository**. This helps us to **make the course more visible 🤗**.
@@ -46,10 +48,10 @@ To cite this repository in publications:
 
 ```
 @misc{mcp-course,
-  author = {Your Name},
+  author = Burtenshaw, Ben,
   title = {The Model Context Protocol Course},
   year = {2025},
-  howpublished = {\url{https://github.com/yourusername/mcp-course}},
+  howpublished = {\url{https://github.com/huggingface/mcp-course}},
   note = {GitHub repository},
 }
 ```

README_vi.md

@@ -0,0 +1,55 @@
+# Khóa Học Về Model Context Protocol (MCP)
+
+<div align="center"> <a href="README.md">🇺🇸 English</a> | <a href="README_vi.md">🇻🇳 Tiếng Việt</a> </div>
+
+![1](https://github.com/user-attachments/assets/d26dcc5e-46cb-449e-aecb-49ece10d342a)
+
+Nếu bạn thích khóa học này, **đừng ngần ngại đánh dấu ⭐ cho repo này**. Điều này giúp chúng ta **làm cho khóa học trở nên phổ biến hơn 🤗**.
+
+<img src="https://huggingface.co/datasets/agents-course/course-images/resolve/main/en/communication/please_star.gif" alt="Đánh dấu sao cho kho lưu trữ" />
+
+## Nội dung
+
+Khóa học được chia thành 4 phần. Những phần này sẽ đưa bạn từ **những kiến thức cơ bản về Model Context Protocol đến một dự án cuối cùng triển khai MCP trong ứng dụng AI**.
+
+Đăng ký tại đây (miễn phí) 👉 [Sắp ra mắt]
+
+Bạn có thể truy cập khóa học tại đây 👉 [Sắp ra mắt]
+
+| Phần    | Chủ đề                                              | Mô tả                                                                                                 |
+| ------- | --------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| 0       | Chào mừng đến với Khóa học                          | Lời chào mừng, hướng dẫn, công cụ cần thiết và tổng quan về khóa học.                                |
+| 1       | Giới thiệu về Model Context Protocol                | Định nghĩa của MCP, các khái niệm chính và vai trò của nó trong việc kết nối mô hình AI với dữ liệu  |
+| 2       | Xây dựng với MCP: Phát triển thực tế                | Học cách triển khai MCP client và server sử dụng SDK và framework có sẵn.                            |
+
+## Điều kiện tiên quyết
+
+* Hiểu biết cơ bản về AI và các khái niệm LLM
+* Quen thuộc với nguyên tắc phát triển phần mềm và khái niệm API
+* Có kinh nghiệm với ít nhất một ngôn ngữ lập trình (các ví dụ sẽ tập trung vào Python hoặc TypeScript)
+
+## Hướng dẫn đóng góp
+
+Nếu bạn muốn đóng góp cho khóa học này, hoan nghênh các bạn. Vui lòng mở issue hoặc gửi pull request. Đối với những đóng góp cụ thể, dưới đây là một số hướng dẫn:
+
+### Sửa lỗi chính tả và ngữ pháp nhỏ
+
+Nếu bạn tìm thấy lỗi chính tả hoặc lỗi ngữ pháp nhỏ, vui lòng tự sửa và gửi pull request. Điều này rất hữu ích cho học viên.
+
+### Phần mới
+
+Nếu bạn muốn thêm một phần mới, **vui lòng tạo một issue trong kho lưu trữ, mô tả phần đó và lý do tại sao nên thêm vào**. Chúng tôi sẽ thảo luận và nếu đó là một bổ sung tốt, chúng ta có thể cộng tác để thực hiện.
+
+## Trích dẫn dự án
+
+Để trích dẫn kho lưu trữ này trong các ấn phẩm:
+
+```
+@misc{mcp-course,
+  author = {Your Name},
+  title = {The Model Context Protocol Course},
+  year = {2025},
+  howpublished = {\url{https://github.com/yourusername/mcp-course}},
+  note = {GitHub repository},
+}
+```

quiz/README.md

@@ -0,0 +1 @@
+# MCP Course quiz scripts

quiz/data/unit_1.json

@@ -0,0 +1,10 @@
+[
+    {
+        "question": "Which of the following best describes a Large Language Model (LLM)?",
+        "answer_a": "A model specializing in language recognition",
+        "answer_b": "A massive neural network that understands and generates human language",
+        "answer_c": "A model exclusively used for language data tasks like summarization or classification",
+        "answer_d": "A rule-based chatbot used for conversations",
+        "correct_answer": "B"
+    }
+]

quiz/push_questions.py

@@ -0,0 +1,31 @@
+import json
+from pathlib import Path
+from datasets import Dataset
+
+ORG_NAME = "mcp-course"
+
+
+def main():
+    """Push quiz questions to the Hugging Face Hub"""
+
+    for file in Path("data").glob("*.json"):
+        print(f"Processing {file}")
+
+        with open(file, "r") as f:
+            quiz_data = json.load(f)
+
+        repo_id = f"{ORG_NAME}/{file.stem}_quiz"
+
+        dataset = Dataset.from_list(quiz_data)
+
+        print(f"Pushing {repo_id} to the Hugging Face Hub")
+
+        dataset.push_to_hub(
+            repo_id,
+            private=True,
+            commit_message=f"Update quiz questions for {file.stem}",
+        )
+
+
+if __name__ == "__main__":
+    main()

quiz/pyproject.toml

@@ -0,0 +1,12 @@
+[project]
+name = "agents-course"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "datasets>=3.2.0",
+    "huggingface-hub>=0.27.1",
+    "ipykernel>=6.29.5",
+    "requests>=2.32.3",
+]