Thực hiện các bước sau để bắt đầu sử dụng các tài nguyên này:
- Fork Repository: Nhấn
- Clone Repository:
git clone https://github.com/microsoft/mcp-for-beginners.git - Tham gia Azure AI Foundry Discord để gặp gỡ các chuyên gia và nhà phát triển khác
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
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 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 tham khảo kỹ thuật
- 📜 Đặc tả MCP gốc – Tài liệu tham khảo 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
| 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 | Đọc thêm |
| 01 | Giải thích các khái niệm cốt lõi | Khám phá chi tiết các khái niệm cốt lõi của MCP | Đọc 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 | Đọc 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 | Đọc thêm |
| Module 3: Xây dựng máy chủ & khách đầu tiên của bạ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 | Khách đầu tiên | Phát triển một khách MCP cơ bản | Hướng dẫn |
| 3.3 | 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 |
| 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 | Đọc 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 | Đọc 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 | Định tuyến | Chiến lược định tuyến MCP | Hướng dẫn |
| 5.6 | Lấy mẫu | 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 web | Triển khai khả năng tìm kiếm 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 |
| 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 vào 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 | 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 | Phòng thí nghiệm |
| Ngôn ngữ | Mô tả | Liên kết |
|---|---|---|
| C# | Ví dụ máy chủ MCP | Xem mã |
| Java | MCP Calculator | Xem mã |
| JavaScript | Demo MCP | Xem mã |
| Python | Máy chủ MCP | Xem mã |
| TypeScript | Ví dụ MCP | Xem mã |
| Rust | Ví dụ MCP | Xem mã |
| 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ã |
Để 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ợ
Kho lưu trữ này bao gồm nhiều tài nguyên để giúp bạn học tập và điều hướng hiệu quả:
Một Hướng dẫn học tập toàn diện có sẵn để giúp bạn điều hướng kho lưu trữ này 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
- Tài nguyên bổ sung để bổ sung hành trình học tập của bạn
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
Mỗi bài học trong hướng dẫn này bao gồm:
- Giải thích rõ ràng các khái niệm MCP
- Ví dụ mã trực tiếp bằng nhiều ngôn ngữ
- Bài tập để xây dựng các ứng dụng MCP thực tế
- Tài nguyên bổ sung cho người học nâng cao
Hãy sẵn sàng cho hai ngày tìm hiểu kỹ thuật sâu sắc, 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.
Tập trung vào việc trao quyền cho 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 bản 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 cộng đồng dẫn dắt và thông tin chi tiết
Dù bạn mới bắt đầu với MCP hay đã xây dựng với nó, Ngày 1 sẽ tạo nền tảng với cảm hứng và các bài học thực tế.
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 tiễn 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.
- 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 tiễn 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 thông tin chi tiế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.
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.
Cảm ơn Microsoft Valued Professional Shivam Goyal đã đóng góp các mẫu mã quan trọng.
Nội dung này được cấp phép theo Giấy phép MIT. Để biết các điều khoản và điều kiện, xem LICENSE.
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 Giấy 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 Quy tắc ứng xử mã nguồn mở của Microsoft. Để biết thêm thông tin, xem Câu hỏi thường gặp về Quy tắc ứng xử 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.
Kho lưu trữ được tổ chức như sau:
- Chương trình học cốt lõi (00-10): Nội dung chính được tổ chức trong mười mô-đun tuần tự
- images/: 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 địa phương hóa của 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: Tài liệu quản trị dự án
Nhóm của chúng tôi sản xuất các khóa học khác! Xem thêm:
- 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
- Mastering GitHub Copilot for C#/.NET Developers
- Choose Your Own Copilot Adventure
Dự án này có thể chứa nhãn hiệu hoặc logo cho các dự án, sản phẩm hoặc dịch vụ. Việc sử dụng nhãn hiệu hoặc logo của Microsoft phải tuân theo và tuân thủ
Hướng dẫn về nhãn hiệu & thương hiệu của Microsoft.
Việc sử dụng nhãn hiệu hoặc logo của Microsoft trong các phiên bản sửa đổi của dự án này không được gây nhầm lẫn hoặc ngụ ý sự tài trợ của Microsoft.
Việc sử dụng nhãn hiệu hoặc logo của bên thứ ba phải tuân theo chính sách của bên thứ ba đó.
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 từ 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.