Skip to content

Latest commit

 

History

History
258 lines (188 loc) · 21.5 KB

File metadata and controls

258 lines (188 loc) · 21.5 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Làm theo các bước sau để bắt đầu sử dụng các tài nguyên này:

  1. Fork Repository: Nhấn vào GitHub forks
  2. Clone Repository: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Tham gia Azure AI Foundry Discord để gặp gỡ các chuyên gia và các nhà phát triển khác

🌐 Hỗ trợ đa ngôn ngữ

Hỗ trợ qua GitHub Action (Tự động & Luôn cập nhật)

French | Spanish | German | Russian | Arabic | Persian (Farsi) | Urdu | Chinese (Simplified) | Chinese (Traditional, Macau) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Taiwan) | Japanese | Korean | Hindi | Bengali | Marathi | Nepali | Punjabi (Gurmukhi) | Portuguese (Portugal) | Portuguese (Brazil) | Italian | Polish | Turkish | Greek | Thai | Swedish | Danish | Norwegian | Finnish | Dutch | Hebrew | Vietnamese | Indonesian | Malay | Tagalog (Filipino) | Swahili | Hungarian | Czech | Slovak | Romanian | Bulgarian | Serbian (Cyrillic) | Croatian | Slovenian | Ukrainian | Burmese (Myanmar)

🚀 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 bằng C#, Java, JavaScript, Python và TypeScript

🧠 Tổng quan về Giáo trình Model Context Protocol

Model Context Protocol (MCP) là một khuôn khổ 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, kèm theo các ví dụ mã thực tế và các trường hợp sử dụng trong thế giới thực, 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 giúp bạn nắm vững các kiến thứ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à ví dụ mã
  • 🌐 Cộng đồng MCP – Tham gia thảo luận và đóng góp cho cộng đồng

Tham gia MCP Dev Days ngày 29-30 tháng 7 năm 2025

Hãy sẵn sàng cho hai ngày trải nghiệm sâu sắc 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, 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.

➡️ Đăng ký MCP Dev Days

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ừ đó, bạn sẽ có thể tham gia xem trực tiếp trên YouTube hoặc Twitch. Tất cả nội dung đều được ghi lại và sẽ có sẵn sau đó trên kênh Microsoft Developer YouTube. Mã nguồn cho các bản demo cũng sẽ được cung cấp trên GitHub.

Thông tin sự kiện

  • Ngày: 29 tháng 7 (Ngày 1) & 30 tháng 7 (Ngày 2)
  • Thời gian: 9:00 sáng theo giờ PST mỗi ngày
  • Địa điểm: Trực tuyến – tham gia từ bất cứ đâu!

Ngày 1: Năng suất MCP, DevTools & Cộng đồng:

Tập trung vào việc hỗ trợ các nhà phát triển sử dụng MCP trong quy trình làm việc và tôn vinh cộng đồng MCP tuyệt vời. Chúng ta sẽ có sự tham gia của 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 xây dựng 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 phát triển dựa trên ngữ cảnh thực tế
Các phiên do cộng đồng dẫn dắt và chia sẻ kiến thức
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 có thể áp dụng ngay.

Ngày 2: Xây dựng MCP Servers với sự tự tin

Dành cho những người xây dựng MCP. Chúng ta sẽ đi sâu vào các chiến lược triển khai và các thực hành tốt nhất để tạo MCP servers và tích hợp MCP vào quy trình AI của bạn.

Các chủ đề bao gồm:

  • Xây dựng MCP Servers 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 bảo mật tốt nhất
  • Sử dụng các khối xây dựng như Functions, ACA và API Management
  • Đồng bộ registry và công cụ (1P + 3P)

Nếu bạn là nhà phát triển, người tạo công cụ hoặc chiến lược gia sản phẩm AI, ngày này sẽ đầy ắp những kiến thức cần thiết để xây dựng các giải pháp MCP có khả năng mở rộng, an toàn và sẵn sàng cho tương lai.

🧭 Tổng quan 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: 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 pipeline AI Đọc 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 Đọ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, server/client cơ bản, tích hợp Đọc thêm
Module 3: Xây dựng Server & Client đầu tiên của bạn
3.1 Server đầu tiên Tạo server MCP đầu tiên của bạn Hướng dẫn
3.2 Client đầu tiên Phát triển client MCP cơ bản Hướng dẫn
3.3 Client 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 MCP servers trong VS Code Hướng dẫn
3.5 Server SSE Tạo server sử dụng Server-Sent Events Hướng dẫn
3.6 HTTP Streaming Triển khai streaming HTTP trong MCP Hướng dẫn
3.7 Bộ công cụ AI Sử dụng AI Toolkit với MCP Hướng dẫn
3.8 Kiểm thử Kiểm thử triển khai server MCP của bạn Hướng dẫn
3.9 Triển khai Triển khai MCP servers vào môi trường sản xuất Hướng dẫn
Module 4-5: Thực tiễn & 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 Chủ đề nâng cao trong MCP AI đa phương thức, mở rộng quy mô, ứng dụng 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 Sampling Kỹ thuật sampling 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 Entra ID Auth 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 Engineering Các kỹ thuật để xây dựng ngữ cảnh 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 từ 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ừ những người áp dụng sớm 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, độ bền bỉ Hướng dẫn
09 Nghiên cứu tình huống MCP Ví dụ triển khai thực tế Hướng dẫn
10 Workshop thực hành Xây dựng MCP Server với AI Toolkit Lab

💻 Dự án Mẫu Code

Mẫu MCP Calculator cơ bản

Ngôn ngữ Mô tả Liên kết
C# Ví dụ MCP Server Xem Code
Java MCP Calculator Xem Code
JavaScript Demo MCP Xem Code
Python MCP Server Xem Code
TypeScript Ví dụ MCP Xem Code

Triển khai MCP nâng cao

Ngôn ngữ Mô tả Liên kết
C# Mẫu nâng cao Xem Code
Java Ví dụ Container App Xem Code
JavaScript Mẫu nâng cao Xem Code
Python Triển khai phức tạp Xem Code
TypeScript Mẫu Container Xem Code

🎯 Yêu cầu cần có để 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) Kiến thức nền tảng về AI/ML

  • Tham gia thảo luận cộng đồng để đượ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 và điều hướng 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 với tất cả các chủ đề được đề cập
  • Phân tích chi tiết từng phần trong kho lưu trữ
  • Hướng dẫn sử dụng các dự án mẫu
  • Lộ trình học đề xuất cho các cấp độ kỹ năng khác nhau
  • Tài nguyên bổ sung để hỗ trợ hành trình học tập của bạn

Nhật ký thay đổi

Chúng tôi duy trì một Nhật ký thay đổi chi tiết ghi lại tất cả các cập nhật quan trọng cho tài liệu chương trình học, bao gồm:

  • Thêm 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 hiệu quả

Mỗi bài học trong hướng dẫn này bao gồm:

  1. Giải thích rõ ràng các khái niệm MCP
  2. Ví dụ code trực tiếp bằng nhiều ngôn ngữ
  3. Bài tập xây dựng ứng dụng MCP thực tế
  4. Tài nguyên bổ sung cho người học nâng cao

🌟 Lời cảm ơn từ cộng đồng

Cảm ơn Microsoft Valued Professional Shivam Goyal đã đóng góp các mẫu code quan trọng.

📜 Thông tin bản quyền

Nội dung này được cấp phép theo MIT License. Để biết đ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à đề xuất. 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) xác nhận 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. Chi tiết xem tại
https://cla.opensource.microsoft.com.

Khi bạn gửi pull request, bot CLA sẽ tự động xác định xem bạn có cần cung cấp CLA hay không và đánh dấu PR phù 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ủa bot. Bạn chỉ cần thực hiện việc này một lần cho tất cả các kho 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 nếu có câu hỏi hoặc góp ý thêm.

📂 Cấu trúc kho lưu trữ

Kho lưu trữ được tổ chức như sau:

  • Core Curriculum (00-10): Nội dung chính được sắp xếp thành mười module liên tiếp
  • images/: Các sơ đồ và hình minh họa sử dụng trong chương trình học
  • translations/: Hỗ trợ đa ngôn ngữ với 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 chép tất cả các thay đổi quan trọng trong 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

🎒 Các khóa học khác

Nhóm chúng tôi còn sản xuất các khóa học khác! Hãy xem:

™️ Thông báo về nhãn hiệu

Dự án này có thể chứa nhãn hiệu hoặc logo của 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à phù hợp với
Hướng dẫn Nhãn hiệu & Thương hiệu của Microsoft.
Việc sử dụng nhãn hiệu hoặc logo 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ụ ý Microsoft tài trợ.
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 các bên đó.

Tuyên bố từ chối 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 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ữ gốc của nó nên được coi là nguồn chính xác và đáng tin cậy. Đối với các thông tin quan trọng, nên sử dụng dịch vụ dịch thuật chuyên nghiệp do con người thực hiện. Chúng tôi không chịu trách nhiệm về bất kỳ sự hiểu lầm hoặc giải thích sai nào phát sinh từ việc sử dụng bản dịch này.