Panduan pembelajaran ini memberikan gambaran keseluruhan tentang struktur repositori dan kandungan untuk kurikulum "Protokol Konteks Model (MCP) untuk Pemula". Gunakan panduan ini untuk menavigasi repositori dengan cekap dan memanfaatkan sumber yang tersedia sepenuhnya.
Protokol Konteks Model (MCP) adalah kerangka kerja standard untuk interaksi antara model AI dan aplikasi klien. Pada mulanya dicipta oleh Anthropic, MCP kini dikendalikan oleh komuniti MCP yang lebih luas melalui organisasi GitHub rasmi. Repositori ini menyediakan kurikulum komprehensif dengan contoh kod praktikal dalam C#, Java, JavaScript, Python, dan TypeScript, direka untuk pembangun AI, arkitek sistem, dan jurutera perisian.
mindmap
root((MCP for Beginners))
00. Introduction
::icon(fa fa-book)
(Protocol Overview)
(Standardization Benefits)
(Real-world Use Cases)
(AI Integration Fundamentals)
01. Core Concepts
::icon(fa fa-puzzle-piece)
(Client-Server Architecture)
(Protocol Components)
(Messaging Patterns)
(Transport Mechanisms)
02. Security
::icon(fa fa-shield)
(AI-Specific Threats)
(Best Practices 2025)
(Azure Content Safety)
(Auth & Authorization)
(Microsoft Prompt Shields)
03. Getting Started
::icon(fa fa-rocket)
(First Server Implementation)
(Client Development)
(LLM Client Integration)
(VS Code Extensions)
(SSE Server Setup)
(HTTP Streaming)
(AI Toolkit Integration)
(Testing Frameworks)
(Deployment Strategies)
04. Practical Implementation
::icon(fa fa-code)
(Multi-Language SDKs)
(Testing & Debugging)
(Prompt Templates)
(Sample Projects)
(Production Patterns)
05. Advanced Topics
::icon(fa fa-graduation-cap)
(Context Engineering)
(Foundry Agent Integration)
(Multi-modal AI Workflows)
(OAuth2 Authentication)
(Real-time Search)
(Streaming Protocols)
(Root Contexts)
(Routing Strategies)
(Sampling Techniques)
(Scaling Solutions)
(Security Hardening)
(Entra ID Integration)
(Web Search MCP)
06. Community
::icon(fa fa-users)
(Code Contributions)
(Documentation)
(MCP Client Ecosystem)
(MCP Server Registry)
(Image Generation Tools)
(GitHub Collaboration)
07. Early Adoption
::icon(fa fa-lightbulb)
(Production Deployments)
(Microsoft MCP Servers)
(Azure MCP Service)
(Enterprise Case Studies)
(Future Roadmap)
08. Best Practices
::icon(fa fa-check)
(Performance Optimization)
(Fault Tolerance)
(System Resilience)
(Monitoring & Observability)
09. Case Studies
::icon(fa fa-file-text)
(Azure API Management)
(AI Travel Agent)
(Azure DevOps Integration)
(Documentation MCP)
(GitHub MCP Registry)
(VS Code Integration)
(Real-world Implementations)
10. Hands-on Workshop
::icon(fa fa-laptop)
(MCP Server Fundamentals)
(Advanced Development)
(AI Toolkit Integration)
(Production Deployment)
(4-Lab Structure)
Repositori ini disusun kepada sepuluh bahagian utama, setiap satu memberi fokus kepada aspek berbeza MCP:
-
Pengenalan (00-Introduction/)
- Gambaran keseluruhan Protokol Konteks Model
- Kepentingan standardisasi dalam saluran AI
- Kes penggunaan praktikal dan manfaatnya
-
Konsep Asas (01-CoreConcepts/)
- Seni bina klien-pelayan
- Komponen utama protokol
- Corak pemesejan dalam MCP
-
Keselamatan (02-Security/)
- Ancaman keselamatan dalam sistem berasaskan MCP
- Amalan terbaik untuk melindungi pelaksanaan
- Strategi pengesahan dan kebenaran
- Dokumentasi Keselamatan Komprehensif:
- Amalan Terbaik Keselamatan MCP 2025
- Panduan Pelaksanaan Keselamatan Kandungan Azure
- Kawalan dan Teknik Keselamatan MCP
- Rujukan Cepat Amalan Terbaik MCP
- Topik Keselamatan Utama:
- Serangan suntikan prompt dan keracunan alat
- Rampasan sesi dan masalah wakil yang keliru
- Kerentanan laluan token
- Kebenaran berlebihan dan kawalan akses
- Keselamatan rantaian bekalan untuk komponen AI
- Integrasi Microsoft Prompt Shields
-
Memulakan (03-GettingStarted/)
- Persediaan dan konfigurasi persekitaran
- Membuat pelayan dan klien MCP asas
- Integrasi dengan aplikasi sedia ada
- Termasuk bahagian untuk:
- Pelaksanaan pelayan pertama
- Pembangunan klien
- Integrasi klien LLM
- Integrasi VS Code
- Pelayan Server-Sent Events (SSE)
- Penstriman HTTP
- Integrasi AI Toolkit
- Strategi ujian
- Garis panduan penyebaran
-
Pelaksanaan Praktikal (04-PracticalImplementation/)
- Menggunakan SDK dalam pelbagai bahasa pengaturcaraan
- Teknik debugging, ujian, dan pengesahan
- Membuat templat prompt dan aliran kerja yang boleh digunakan semula
- Projek contoh dengan contoh pelaksanaan
-
Topik Lanjutan (05-AdvancedTopics/)
- Teknik kejuruteraan konteks
- Integrasi agen Foundry
- Aliran kerja AI multi-modal
- Demo pengesahan OAuth2
- Keupayaan carian masa nyata
- Penstriman masa nyata
- Pelaksanaan konteks akar
- Strategi penghalaan
- Teknik pensampelan
- Pendekatan penskalaan
- Pertimbangan keselamatan
- Integrasi keselamatan Entra ID
- Integrasi carian web
-
Sumbangan Komuniti (06-CommunityContributions/)
- Cara menyumbang kod dan dokumentasi
- Bekerjasama melalui GitHub
- Penambahbaikan dan maklum balas yang didorong oleh komuniti
- Menggunakan pelbagai klien MCP (Claude Desktop, Cline, VSCode)
- Bekerja dengan pelayan MCP popular termasuk penjanaan imej
-
Pengajaran daripada Penggunaan Awal (07-LessonsfromEarlyAdoption/)
- Pelaksanaan dunia sebenar dan kisah kejayaan
- Membina dan menyebarkan penyelesaian berasaskan MCP
- Trend dan peta jalan masa depan
- Panduan Pelayan MCP Microsoft: Panduan komprehensif kepada 10 pelayan MCP Microsoft yang sedia untuk pengeluaran termasuk:
- Pelayan MCP Microsoft Learn Docs
- Pelayan MCP Azure (15+ penyambung khusus)
- Pelayan MCP GitHub
- Pelayan MCP Azure DevOps
- Pelayan MCP MarkItDown
- Pelayan MCP SQL Server
- Pelayan MCP Playwright
- Pelayan MCP Dev Box
- Pelayan MCP Azure AI Foundry
- Pelayan MCP Microsoft 365 Agents Toolkit
-
Amalan Terbaik (08-BestPractices/)
- Penalaan prestasi dan pengoptimuman
- Reka bentuk sistem MCP yang tahan kerosakan
- Strategi ujian dan ketahanan
-
Kajian Kes (09-CaseStudy/)
- Tujuh kajian kes komprehensif yang menunjukkan kepelbagaian MCP dalam pelbagai senario:
- Ejen Perjalanan AI Azure: Orkestrasi multi-agen dengan Azure OpenAI dan AI Search
- Integrasi Azure DevOps: Mengautomasi proses aliran kerja dengan kemas kini data YouTube
- Pengambilan Dokumentasi Masa Nyata: Klien konsol Python dengan penstriman HTTP
- Penjana Pelan Pembelajaran Interaktif: Aplikasi web Chainlit dengan AI perbualan
- Dokumentasi Dalam Editor: Integrasi VS Code dengan aliran kerja GitHub Copilot
- Pengurusan API Azure: Integrasi API perusahaan dengan penciptaan pelayan MCP
- Pendaftaran MCP GitHub: Pembangunan ekosistem dan platform integrasi agen
- Contoh pelaksanaan merangkumi integrasi perusahaan, produktiviti pembangun, dan pembangunan ekosistem
-
Bengkel Praktikal (10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/)
- Bengkel praktikal komprehensif menggabungkan MCP dengan AI Toolkit
- Membina aplikasi pintar yang menghubungkan model AI dengan alat dunia sebenar
- Modul praktikal merangkumi asas, pembangunan pelayan khusus, dan strategi penyebaran pengeluaran
- Struktur Makmal:
- Makmal 1: Asas Pelayan MCP
- Makmal 2: Pembangunan Pelayan MCP Lanjutan
- Makmal 3: Integrasi AI Toolkit
- Makmal 4: Penyebaran Pengeluaran dan Penskalaan
- Pendekatan pembelajaran berasaskan makmal dengan arahan langkah demi langkah
Repositori ini termasuk sumber sokongan:
- Folder Imej: Mengandungi diagram dan ilustrasi yang digunakan sepanjang kurikulum
- Terjemahan: Sokongan pelbagai bahasa dengan terjemahan dokumentasi automatik
- Sumber Rasmi MCP:
- Pembelajaran Berurutan: Ikuti bab-bab mengikut urutan (00 hingga 10) untuk pengalaman pembelajaran yang terstruktur.
- Fokus Khusus Bahasa: Jika anda berminat dengan bahasa pengaturcaraan tertentu, terokai direktori sampel untuk pelaksanaan dalam bahasa pilihan anda.
- Pelaksanaan Praktikal: Mulakan dengan bahagian "Memulakan" untuk menyediakan persekitaran anda dan mencipta pelayan dan klien MCP pertama anda.
- Penerokaan Lanjutan: Setelah selesa dengan asas, terokai topik lanjutan untuk memperluaskan pengetahuan anda.
- Penglibatan Komuniti: Sertai komuniti MCP melalui perbincangan GitHub dan saluran Discord untuk berhubung dengan pakar dan pembangun lain.
Kurikulum ini merangkumi pelbagai klien dan alat MCP:
-
Klien Rasmi:
- Visual Studio Code
- MCP dalam Visual Studio Code
- Claude Desktop
- Claude dalam VSCode
- Claude API
-
Klien Komuniti:
- Cline (berasaskan terminal)
- Cursor (editor kod)
- ChatMCP
- Windsurf
-
Alat Pengurusan MCP:
- MCP CLI
- MCP Manager
- MCP Linker
- MCP Router
Repositori ini memperkenalkan pelbagai pelayan MCP, termasuk:
-
Pelayan MCP Microsoft Rasmi:
- Pelayan MCP Microsoft Learn Docs
- Pelayan MCP Azure (15+ penyambung khusus)
- Pelayan MCP GitHub
- Pelayan MCP Azure DevOps
- Pelayan MCP MarkItDown
- Pelayan MCP SQL Server
- Pelayan MCP Playwright
- Pelayan MCP Dev Box
- Pelayan MCP Azure AI Foundry
- Pelayan MCP Microsoft 365 Agents Toolkit
-
Pelayan Rujukan Rasmi:
- Filesystem
- Fetch
- Memory
- Sequential Thinking
-
Penjanaan Imej:
- Azure OpenAI DALL-E 3
- Stable Diffusion WebUI
- Replicate
-
Alat Pembangunan:
- Git MCP
- Kawalan Terminal
- Pembantu Kod
-
Pelayan Khusus:
- Salesforce
- Microsoft Teams
- Jira & Confluence
Repositori ini mengalu-alukan sumbangan daripada komuniti. Lihat bahagian Sumbangan Komuniti untuk panduan tentang cara menyumbang dengan berkesan kepada ekosistem MCP.
| Tarikh | Perubahan |
|---|---|
| 26 September 2025 | - Menambah kajian kes Pendaftaran MCP GitHub ke bahagian 09-CaseStudy - Mengemas kini Kajian Kes untuk mencerminkan tujuh kajian kes komprehensif - Mempertingkatkan penerangan kajian kes dengan butiran pelaksanaan khusus - Mengemas kini Peta Kurikulum Visual untuk memasukkan Pendaftaran MCP GitHub - Menyemak semula struktur panduan pembelajaran untuk mencerminkan fokus pembangunan ekosistem |
| 18 Julai 2025 | - Mengemas kini struktur repositori untuk memasukkan Panduan Pelayan MCP Microsoft - Menambah senarai komprehensif 10 pelayan MCP Microsoft yang sedia untuk pengeluaran - Mempertingkatkan bahagian Pelayan MCP Popular dengan Pelayan MCP Microsoft Rasmi - Mengemas kini bahagian Kajian Kes dengan contoh fail sebenar - Menambah butiran Struktur Makmal untuk Bengkel Praktikal |
| 16 Julai 2025 | - Mengemas kini struktur repositori untuk mencerminkan kandungan semasa - Menambah bahagian Klien dan Alat MCP - Menambah bahagian Pelayan MCP Popular - Mengemas kini Peta Kurikulum Visual dengan semua topik semasa - Mempertingkatkan bahagian Topik Lanjutan dengan semua kawasan khusus - Mengemas kini Kajian Kes untuk mencerminkan contoh sebenar - Menjelaskan asal usul MCP sebagai ciptaan Anthropic |
| 11 Jun 2025 | - Penciptaan awal panduan pembelajaran - Menambah Peta Kurikulum Visual - Menggariskan struktur repositori - Termasuk projek contoh dan sumber tambahan |
Panduan pembelajaran ini dikemas kini pada 26 September 2025, dan memberikan gambaran keseluruhan repositori sehingga tarikh tersebut. Kandungan repositori mungkin dikemas kini selepas tarikh ini.