Thực hiện các bước sau để bắt đầu sử dụng tài nguyên này:
- Fork Repository: Nhấn
- Clone Repository:
git clone https://github.com/microsoft/mcp-for-beginners.git - Tham gia Discord Azure AI Foundry để gặp gỡ chuyên gia và các nhà phát triển khác
🌐 Hỗ trợ đa ngôn ngữ
Được hỗ trợ qua GitHub Action (Tự động & Luôn cập nhật)
Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Korean | Malay | Marathi | Nepali | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Thai | Turkish | Ukrainian | Urdu | Vietnamese
🚀 Giáo trình Model Context Protocol (MCP) dành cho người mới bắt đầu
Học MCP với các ví dụ mã thực hành trong C#, Java, JavaScript, Rust, Python và TypeScript
🧠 Tổng quan về giáo trình Model Context Protocol
Model Context Protocol (MCP) là một khung làm việc tiên tiến được thiết kế để chuẩn hóa các tương tác giữa các mô hình AI và ứng dụng khách. Giáo trình mã nguồn mở này cung cấp một lộ trình học tập có cấu trúc, bao gồm các ví dụ mã thực hành và các trường hợp sử dụng thực tế, trên các ngôn ngữ lập trình phổ biến như C#, Java, JavaScript, TypeScript và Python.
Dù bạn là nhà phát triển AI, kiến trúc sư hệ thống hay kỹ sư phần mềm, hướng dẫn này là tài nguyên toàn diện để bạn nắm vững các nguyên tắc cơ bản và chiến lược triển khai MCP.
🔗 Tài nguyên chính thức của MCP
- 📘 Tài liệu MCP – Hướng dẫn chi tiết và tài liệu người dùng
- 📜 Đặc tả MCP – Kiến trúc giao thức và tài liệu kỹ thuật
- 📜 Đặc tả MCP gốc – Tài liệu kỹ thuật cũ (có thể chứa thêm chi tiết)
- 🧑💻 Kho GitHub MCP – SDK mã nguồn mở, công cụ và mẫu mã
- 🌐 Cộng đồng MCP – Tham gia thảo luận và đóng góp cho cộng đồng
🧭 Tổng quan về giáo trình MCP
📚 Cấu trúc giáo trình đầy đủ
| Module | Chủ đề | Mô tả | Liên kết |
|---|---|---|---|
| Module 1-3: Kiến thức cơ bản | |||
| 00 | Giới thiệu về MCP | Tổng quan về Model Context Protocol và tầm quan trọng của nó trong các quy trình AI | Xem thêm |
| 01 | Giải thích các khái niệm cốt lõi | Khám phá sâu các khái niệm cốt lõi của MCP | Xem thêm |
| 02 | Bảo mật trong MCP | Các mối đe dọa bảo mật và thực hành tốt nhất | Xem thêm |
| 03 | Bắt đầu với MCP | Thiết lập môi trường, máy chủ/khách cơ bản, tích hợp | Xem thêm |
| Module 3: Xây dựng máy chủ & ứng dụng khách đầu tiên | |||
| 3.1 | Máy chủ đầu tiên | Tạo máy chủ MCP đầu tiên của bạn | Hướng dẫn |
| 3.2 | Ứng dụng khách đầu tiên | Phát triển ứng dụng khách MCP cơ bản | Hướng dẫn |
| 3.3 | Ứng dụng khách với LLM | Tích hợp các mô hình ngôn ngữ lớn | Hướng dẫn |
| 3.4 | Tích hợp VS Code | Sử dụng máy chủ MCP trong VS Code | Hướng dẫn |
| 3.5 | Máy chủ stdio | Tạo máy chủ sử dụng giao thức stdio | Hướng dẫn |
| 3.6 | HTTP Streaming | Triển khai HTTP streaming trong MCP | Hướng dẫn |
| 3.7 | Bộ công cụ AI | Sử dụng bộ công cụ AI với MCP | Hướng dẫn |
| 3.8 | Kiểm thử | Kiểm thử triển khai máy chủ MCP của bạn | Hướng dẫn |
| 3.9 | Triển khai | Triển khai máy chủ MCP vào môi trường sản xuất | Hướng dẫn |
| 3.10 | Sử dụng máy chủ nâng cao | Sử dụng máy chủ nâng cao để khai thác các tính năng và cải thiện kiến trúc | Hướng dẫn |
| 3.11 | Xác thực đơn giản | Một chương trình hướng dẫn bạn về xác thực từ đầu và RBAC | Hướng dẫn |
| Module 4-5: Thực hành & Nâng cao | |||
| 04 | Triển khai thực tế | SDK, gỡ lỗi, kiểm thử, mẫu prompt tái sử dụng | Xem thêm |
| 05 | Các chủ đề nâng cao trong MCP | AI đa phương thức, mở rộng quy mô, sử dụng trong doanh nghiệp | Xem thêm |
| 5.1 | Tích hợp Azure | Tích hợp MCP với Azure | Hướng dẫn |
| 5.2 | Đa phương thức | Làm việc với nhiều phương thức | Hướng dẫn |
| 5.3 | Demo OAuth2 | Triển khai xác thực OAuth2 | Hướng dẫn |
| 5.4 | Root Contexts | Hiểu và triển khai root contexts | Hướng dẫn |
| 5.5 | Routing | Chiến lược định tuyến MCP | Hướng dẫn |
| 5.6 | Sampling | Kỹ thuật lấy mẫu trong MCP | Hướng dẫn |
| 5.7 | Mở rộng quy mô | Mở rộng triển khai MCP | Hướng dẫn |
| 5.8 | Bảo mật | Các cân nhắc bảo mật nâng cao | Hướng dẫn |
| 5.9 | Tìm kiếm trên web | Triển khai khả năng tìm kiếm trên web | Hướng dẫn |
| 5.10 | Streaming thời gian thực | Xây dựng chức năng streaming thời gian thực | Hướng dẫn |
| 5.11 | Tìm kiếm thời gian thực | Triển khai tìm kiếm thời gian thực | Hướng dẫn |
| 5.12 | Xác thực Entra ID | Xác thực với Microsoft Entra ID | Hướng dẫn |
| 5.13 | Tích hợp Foundry | Tích hợp với Azure AI Foundry | Hướng dẫn |
| 5.14 | Kỹ thuật Context | Kỹ thuật để xây dựng context hiệu quả | Hướng dẫn |
| 5.15 | Giao thức vận chuyển tùy chỉnh MCP | Triển khai giao thức vận chuyển tùy chỉnh | Hướng dẫn |
| Module 6-10: Cộng đồng & Thực hành tốt nhất | |||
| 06 | Đóng góp cộng đồng | Cách đóng góp cho hệ sinh thái MCP | Hướng dẫn |
| 07 | Bài học từ việc áp dụng sớm | Các câu chuyện triển khai thực tế | Hướng dẫn |
| 08 | Thực hành tốt nhất cho MCP | Hiệu suất, khả năng chịu lỗi, khả năng phục hồi | Hướng dẫn |
| 09 | Nghiên cứu trường hợp MCP | Các ví dụ triển khai thực tế | Hướng dẫn |
| 10 | Hội thảo thực hành | Xây dựng máy chủ MCP với bộ công cụ AI | Lab |
| Module 11: Phòng thực hành máy chủ MCP | |||
| 11 | Tích hợp cơ sở dữ liệu máy chủ MCP | Lộ trình học tập thực hành gồm 13 bài về tích hợp PostgreSQL | Labs |
| 11.1 | Giới thiệu | Tổng quan về MCP với tích hợp cơ sở dữ liệu và trường hợp sử dụng phân tích bán lẻ | Lab 00 |
| 11.2 | Kiến trúc cốt lõi | Hiểu về kiến trúc máy chủ MCP, các lớp cơ sở dữ liệu và mô hình bảo mật | Lab 01 |
| 11.3 | Bảo mật & Đa người dùng | Bảo mật cấp hàng, xác thực và truy cập dữ liệu đa người dùng | Lab 02 |
| 11.4 | Thiết lập môi trường | Thiết lập môi trường phát triển, Docker, tài nguyên Azure | Lab 03 |
| 11.5 | Thiết kế cơ sở dữ liệu | Cài đặt PostgreSQL, thiết kế sơ đồ bán lẻ và dữ liệu mẫu | Lab 04 |
| 11.6 | Triển khai máy chủ MCP | Xây dựng máy chủ FastMCP với tích hợp cơ sở dữ liệu | Lab 05 |
| 11.7 | Phát triển công cụ | Tạo công cụ truy vấn cơ sở dữ liệu và kiểm tra sơ đồ | Lab 06 |
| 11.8 | Tìm kiếm ngữ nghĩa | Triển khai vector embeddings với Azure OpenAI và pgvector | Lab 07 |
| 11.9 | Kiểm thử & Gỡ lỗi | Chiến lược kiểm thử, công cụ gỡ lỗi và phương pháp xác thực | Lab 08 |
| 11.10 | Tích hợp VS Code | Cấu hình tích hợp MCP với VS Code và sử dụng AI Chat | Lab 09 |
| 11.11 | Chiến lược triển khai | Triển khai Docker, Azure Container Apps và các cân nhắc về mở rộng | Lab 10 |
| 11.12 | Giám sát | Application Insights, ghi nhật ký, giám sát hiệu suất | Lab 11 |
| 11.13 | Thực hành tốt nhất | Tối ưu hóa hiệu suất, tăng cường bảo mật và mẹo sản xuất | Lab 12 |
💻 Dự án mẫu mã nguồn
Mẫu MCP Calculator cơ bản
| Ngôn ngữ | Mô tả | Liên kết |
|---|---|---|
| C# | Ví dụ máy chủ MCP | Xem mã |
| Java | MCP Calculator | Xem mã |
| JavaScript | MCP Demo | Xem mã |
| Python | Máy chủ MCP | Xem mã |
| TypeScript | Ví dụ MCP | Xem mã |
| Rust | Ví dụ MCP | Xem mã |
Triển khai MCP nâng cao
| Ngôn ngữ | Mô tả | Liên kết |
|---|---|---|
| C# | Mẫu nâng cao | Xem mã |
| Java với Spring | Ví dụ ứng dụng container | Xem mã |
| JavaScript | Mẫu nâng cao | Xem mã |
| Python | Triển khai phức tạp | Xem mã |
| TypeScript | Mẫu container | Xem mã |
🎯 Yêu cầu trước khi học MCP
Để tận dụng tối đa chương trình học này, bạn nên có:
Kiến thức cơ bản về lập trình ít nhất một trong các ngôn ngữ sau: C#, Java, JavaScript, Python hoặc TypeScript
Hiểu biết về mô hình client-server và API
Quen thuộc với các khái niệm REST và HTTP
(Tùy chọn) Nền tảng về các khái niệm AI/ML
Tham gia các cuộc thảo luận cộng đồng của chúng tôi để được hỗ trợ
📚 Hướng dẫn học & Tài nguyên
Kho lưu trữ này bao gồm nhiều tài nguyên để giúp bạn học tập hiệu quả:
Hướng dẫn học
Một Hướng dẫn học toàn diện có sẵn để giúp bạn điều hướng kho lưu trữ này một cách hiệu quả. Hướng dẫn bao gồm:
- Bản đồ chương trình học trực quan hiển thị tất cả các chủ đề được đề cập
- Phân tích chi tiết từng phần của kho lưu trữ
- Hướng dẫn cách sử dụng các dự án mẫu
- Lộ trình học tập được đề xuất cho các cấp độ kỹ năng khác nhau
- Các tài nguyên bổ sung để bổ sung cho hành trình học tập của bạn
Changelog
Chúng tôi duy trì một Changelog chi tiết theo dõi tất cả các cập nhật quan trọng đối với tài liệu chương trình học, bao gồm:
- Bổ sung nội dung mới
- Thay đổi cấu trúc
- Cải tiến tính năng
- Cập nhật tài liệu
🛠️ Cách sử dụng chương trình học này hiệu quả
Mỗi bài học trong hướng dẫn này bao gồm:
- Giải thích rõ ràng về các khái niệm MCP
- Ví dụ mã nguồn trực tiếp bằng nhiều ngôn ngữ
- Bài tập để xây dựng ứng dụng MCP thực tế
- Tài nguyên bổ sung cho người học nâng cao
Sự kiện
MCP Dev Days Tháng 7 năm 2025
➡️Xem theo yêu cầu - MCP Dev Days
Hãy sẵn sàng cho hai ngày tìm hiểu sâu về kỹ thuật, kết nối cộng đồng và học tập thực hành tại MCP Dev Days, một sự kiện trực tuyến dành riêng cho Model Context Protocol (MCP) — tiêu chuẩn mới nổi kết nối các mô hình AI và các công cụ mà chúng dựa vào.
Bạn có thể xem MCP Dev Days bằng cách đăng ký trên trang sự kiện của chúng tôi: https://aka.ms/mcpdevdays.
Ngày 1: Năng suất MCP, DevTools & Cộng đồng:
Tập trung vào việc giúp các nhà phát triển sử dụng MCP trong quy trình làm việc của họ và tôn vinh cộng đồng MCP tuyệt vời. Chúng tôi sẽ cùng các thành viên cộng đồng và đối tác như Arcade, Block, Okta và Neon để xem cách họ hợp tác với Microsoft để định hình một hệ sinh thái MCP mở và có thể mở rộng.
Các demo thực tế trên VS Code, Visual Studio, GitHub Copilot và các công cụ cộng đồng phổ biến
Quy trình làm việc phát triển theo ngữ cảnh thực tế
Các phiên do cộng đồng dẫn dắt và những hiểu biết sâu sắc
Dù bạn mới bắt đầu với MCP hay đã xây dựng với nó, Ngày 1 sẽ mang lại cảm hứng và các bài học thực tế.
Ngày 2: Xây dựng máy chủ MCP với sự tự tin
Dành cho những người xây dựng MCP. Chúng tôi sẽ đi sâu vào các chiến lược triển khai và thực hành tốt nhất để tạo máy chủ MCP và tích hợp MCP vào quy trình làm việc AI của bạn.
Các chủ đề bao gồm:
- Xây dựng máy chủ MCP và tích hợp chúng vào trải nghiệm agent
- Phát triển dựa trên prompt
- Các thực hành tốt nhất về bảo mật
- Sử dụng các khối xây dựng như Functions, ACA và API Management
- Căn chỉnh registry và công cụ (1P + 3P)
Nếu bạn là nhà phát triển, người xây dựng công cụ hoặc chiến lược gia sản phẩm AI, ngày này sẽ cung cấp những hiểu biết bạn cần để xây dựng các giải pháp MCP có thể mở rộng, an toàn và sẵn sàng cho tương lai.
MCP Boot Camp Tháng 8 năm 2025
Học qua các video chuyên sâu cách tạo máy chủ MCP, tích hợp với VS Code và triển khai chuyên nghiệp trên Azure dựa trên nội dung từ chương trình học MCP cho người mới bắt đầu. Bạn sẽ có được các kỹ năng thực tế trong một công nghệ mà các công ty lớn đã sử dụng.
➡️Xem theo yêu cầu MCP Bootcamp | Tiếng Anh
➡️Xem theo yêu cầu MCP Bootcamp | Brasil
➡️Xem theo yêu cầu MCP Bootcamp | Tiếng Tây Ban Nha
Học MCP với C# - Chuỗi hướng dẫn
Hãy cùng tìm hiểu về Model Context Protocol (MCP), một khung công nghệ tiên tiến được thiết kế để chuẩn hóa các tương tác giữa các mô hình AI và ứng dụng khách. Qua buổi học thân thiện với người mới bắt đầu này, chúng tôi sẽ giới thiệu MCP và hướng dẫn bạn tạo máy chủ MCP đầu tiên của mình.
C#: https://aka.ms/letslearnmcp-csharp
Java: https://aka.ms/letslearnmcp-java
JavaScript: https://aka.ms/letslearnmcp-javascript
Python: https://aka.ms/letslearnmcp-python
🌟 Cảm ơn cộng đồng
Cảm ơn Microsoft Valued Professional Shivam Goyal đã đóng góp các mẫu mã nguồn quan trọng.
📜 Thông tin giấy phép
Nội dung này được cấp phép theo MIT License. Để biết các điều khoản và điều kiện, xem LICENSE.
🤝 Hướng dẫn đóng góp
Dự án này hoan nghênh các đóng góp và gợi ý. Hầu hết các đóng góp yêu cầu bạn đồng ý với Thỏa thuận cấp phép người đóng góp (CLA) tuyên bố rằng bạn có quyền và thực sự cấp cho chúng tôi quyền sử dụng đóng góp của bạn. Để biết chi tiết, truy cập https://cla.opensource.microsoft.com.
Khi bạn gửi một pull request, bot CLA sẽ tự động xác định liệu bạn có cần cung cấp CLA và trang trí PR một cách thích hợp (ví dụ: kiểm tra trạng thái, bình luận). Chỉ cần làm theo hướng dẫn được cung cấp bởi bot. Bạn chỉ cần làm điều này một lần trên tất cả các kho lưu trữ sử dụng CLA của chúng tôi.
Dự án này đã áp dụng Microsoft Open Source Code of Conduct. Để biết thêm thông tin, xem Code of Conduct FAQ hoặc liên hệ opencode@microsoft.com với bất kỳ câu hỏi hoặc nhận xét bổ sung nào.
📂 Cấu trúc kho lưu trữ
Kho lưu trữ được tổ chức như sau:
- Chương trình học cốt lõi (00-11): Nội dung chính được tổ chức thành mười một mô-đun tuần tự, bao gồm các bài thực hành tích hợp cơ sở dữ liệu toàn diện
- 11-MCPServerHandsOnLabs/: Lộ trình học tập gồm 13 bài thực hành để xây dựng máy chủ MCP sẵn sàng sản xuất với tích hợp PostgreSQL
- images/: Các sơ đồ và hình minh họa được sử dụng trong toàn bộ chương trình học
- translations/: Hỗ trợ đa ngôn ngữ với các bản dịch tự động
- translated_images/: Phiên bản được bản địa hóa của các sơ đồ và hình minh họa
- study_guide.md: Hướng dẫn toàn diện để điều hướng kho lưu trữ
- changelog.md: Ghi lại tất cả các thay đổi quan trọng đối với tài liệu chương trình học
- mcp.json: Tệp cấu hình cho đặc tả MCP
- CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Các tài liệu quản trị dự án
🎒 Các khóa học khác
Nhóm của chúng tôi sản xuất các khóa học khác! Xem thêm:
- MỚI Edge AI For Beginners
- AI Agents For Beginners
- Generative AI for Beginners using .NET
- Generative AI for Beginners using JavaScript
- Generative AI for Beginners
- Generative AI for Beginners using Java
- ML for Beginners
- Data Science for Beginners
- AI for Beginners
- Cybersecurity for Beginners
- Web Dev for Beginners
- IoT for Beginners
- XR Development for Beginners
- Mastering GitHub Copilot for AI Paired Programming
- Làm chủ GitHub Copilot dành cho các nhà phát triển C#/.NET
- Chọn Cuộc Phiêu Lưu Copilot của Riêng Bạn
™️ Thông Báo Về Thương Hiệu
Dự án này có thể chứa các thương hiệu hoặc logo liên quan đến các dự án, sản phẩm, hoặc dịch vụ. Việc sử dụng hợp pháp các thương hiệu hoặc logo của Microsoft phải tuân theo và phù hợp với Hướng Dẫn Về Thương Hiệu & Nhãn Hiệu của Microsoft. Việc sử dụng các thương hiệu hoặc logo của Microsoft trong các phiên bản đã chỉnh sửa của dự án này không được gây nhầm lẫn hoặc ngụ ý rằng Microsoft tài trợ. Bất kỳ việc sử dụng thương hiệu hoặc logo của bên thứ ba nào đều phải tuân theo chính sách của bên thứ ba đó.
Nhận Hỗ Trợ
Nếu bạn gặp khó khăn hoặc có bất kỳ câu hỏi nào về việc xây dựng ứng dụng AI, hãy tham gia:
Nếu bạn có phản hồi về sản phẩm hoặc gặp lỗi trong quá trình xây dựng, hãy truy cập:
Tuyên bố miễn trừ trách nhiệm:
Tài liệu này đã được dịch bằng dịch vụ dịch thuật AI Co-op Translator. Mặc dù chúng tôi cố gắng đảm bảo độ chính xác, xin lưu ý rằng các bản dịch tự động có thể chứa lỗi hoặc không chính xác. Tài liệu gốc bằng ngôn ngữ bản địa nên được coi là nguồn thông tin chính thức. Đối với các thông tin quan trọng, khuyến nghị sử dụng dịch vụ dịch thuật chuyên nghiệp bởi con người. Chúng tôi không chịu trách nhiệm cho bất kỳ sự hiểu lầm hoặc diễn giải sai nào phát sinh từ việc sử dụng bản dịch này.