Ikuti langkah-langkah ini untuk mula menggunakan sumber ini:
- Fork Repositori: Klik
- Clone Repositori:
git clone https://github.com/microsoft/mcp-for-beginners.git - Sertai Discord Azure AI Foundry dan berhubung dengan pakar serta pembangun lain
🌐 Sokongan Pelbagai Bahasa
Disokong melalui GitHub Action (Automatik & Sentiasa Terkini)
Arab | Bengali | Bulgaria | Burma (Myanmar) | Cina (Ringkas) | Cina (Tradisional, Hong Kong) | Cina (Tradisional, Macau) | Cina (Tradisional, Taiwan) | Croatia | Czech | Denmark | Belanda | Finland | Perancis | Jerman | Yunani | Ibrani | Hindi | Hungary | Indonesia | Itali | Jepun | Korea | Melayu | Marathi | Nepal | Norway | Parsi (Farsi) | Poland | Portugis (Brazil) | Portugis (Portugal) | Punjabi (Gurmukhi) | Romania | Rusia | Serbia (Cyrillic) | Slovak | Slovenia | Sepanyol | Swahili | Sweden | Tagalog (Filipina) | Thai | Turki | Ukraine | Urdu | Vietnam
🚀 Kurikulum Model Context Protocol (MCP) untuk Pemula
Belajar MCP dengan Contoh Kod Praktikal dalam C#, Java, JavaScript, Rust, Python, dan TypeScript
🧠 Gambaran Keseluruhan Kurikulum Model Context Protocol
Model Context Protocol (MCP) adalah rangka kerja terkini yang direka untuk menyeragamkan interaksi antara model AI dan aplikasi klien. Kurikulum sumber terbuka ini menawarkan laluan pembelajaran yang terstruktur, lengkap dengan contoh kod praktikal dan kes penggunaan dunia sebenar, merangkumi bahasa pengaturcaraan popular seperti C#, Java, JavaScript, TypeScript, dan Python.
Sama ada anda seorang pembangun AI, arkitek sistem, atau jurutera perisian, panduan ini adalah sumber komprehensif untuk menguasai asas MCP dan strategi pelaksanaannya.
🔗 Sumber Rasmi MCP
- 📘 Dokumentasi MCP – Tutorial dan panduan pengguna terperinci
- 📜 Spesifikasi MCP – Rujukan teknikal dan seni bina protokol
- 📜 Spesifikasi MCP Asal – Rujukan teknikal lama (mungkin mengandungi butiran tambahan)
- 🧑💻 Repositori GitHub MCP – SDK sumber terbuka, alat, dan contoh kod
- 🌐 Komuniti MCP – Sertai perbincangan dan sumbang kepada komuniti
🧭 Gambaran Keseluruhan Kurikulum MCP
📚 Struktur Kurikulum Lengkap
| Modul | Topik | Penerangan | Pautan |
|---|---|---|---|
| Modul 1-3: Asas | |||
| 00 | Pengenalan kepada MCP | Gambaran keseluruhan Model Context Protocol dan kepentingannya dalam saluran AI | Baca lebih lanjut |
| 01 | Konsep Teras Dijelaskan | Penjelasan mendalam tentang konsep teras MCP | Baca lebih lanjut |
| 02 | Keselamatan dalam MCP | Ancaman keselamatan dan amalan terbaik | Baca lebih lanjut |
| 03 | Memulakan MCP | Persediaan persekitaran, pelayan/klien asas, integrasi | Baca lebih lanjut |
| Modul 3: Membina Pelayan & Klien Pertama Anda | |||
| 3.1 | Pelayan Pertama | Cipta pelayan MCP pertama anda | Panduan |
| 3.2 | Klien Pertama | Bangunkan klien MCP asas | Panduan |
| 3.3 | Klien dengan LLM | Integrasi model bahasa besar | Panduan |
| 3.4 | Integrasi VS Code | Konsum pelayan MCP dalam VS Code | Panduan |
| 3.5 | Pelayan stdio | Cipta pelayan menggunakan pengangkutan stdio | Panduan |
| 3.6 | Penstriman HTTP | Laksanakan penstriman HTTP dalam MCP | Panduan |
| 3.7 | Toolkit AI | Gunakan Toolkit AI dengan MCP | Panduan |
| 3.8 | Ujian | Uji pelaksanaan pelayan MCP anda | Panduan |
| 3.9 | Penghantaran | Hantar pelayan MCP ke pengeluaran | Panduan |
| 3.10 | Penggunaan pelayan lanjutan | Gunakan pelayan lanjutan untuk penggunaan ciri lanjutan dan seni bina yang lebih baik | Panduan |
| 3.11 | Pengesahan mudah | Bab yang menunjukkan pengesahan dari awal dan RBAC | Panduan |
| Modul 4-5: Praktikal & Lanjutan | |||
| 04 | Pelaksanaan Praktikal | SDK, debugging, ujian, templat prompt yang boleh digunakan semula | Baca lebih lanjut |
| 05 | Topik Lanjutan dalam MCP | AI multi-modal, penskalaan, penggunaan perusahaan | Baca lebih lanjut |
| 5.1 | Integrasi Azure | Integrasi MCP dengan Azure | Panduan |
| 5.2 | Multi-modaliti | Bekerja dengan pelbagai modaliti | Panduan |
| 5.3 | Demo OAuth2 | Laksanakan pengesahan OAuth2 | Panduan |
| 5.4 | Konteks Akar | Fahami dan laksanakan konteks akar | Panduan |
| 5.5 | Penghalaan | Strategi penghalaan MCP | Panduan |
| 5.6 | Pensampelan | Teknik pensampelan dalam MCP | Panduan |
| 5.7 | Penskalaan | Skala pelaksanaan MCP | Panduan |
| 5.8 | Keselamatan | Pertimbangan keselamatan lanjutan | Panduan |
| 5.9 | Carian Web | Laksanakan keupayaan carian web | Panduan |
| 5.10 | Penstriman Masa Nyata | Bina fungsi penstriman masa nyata | Panduan |
| 5.11 | Carian Masa Nyata | Laksanakan carian masa nyata | Panduan |
| 5.12 | Pengesahan Entra ID | Pengesahan dengan Microsoft Entra ID | Panduan |
| 5.13 | Integrasi Foundry | Integrasi dengan Azure AI Foundry | Panduan |
| 5.14 | Kejuruteraan Konteks | Teknik untuk kejuruteraan konteks yang berkesan | Panduan |
| 5.15 | Pengangkutan MCP Tersuai | Pelaksanaan Pengangkutan Tersuai | Panduan |
| Modul 6-10: Komuniti & Amalan Terbaik | |||
| 06 | Sumbangan Komuniti | Cara menyumbang kepada ekosistem MCP | Panduan |
| 07 | Wawasan daripada Penggunaan Awal | Kisah pelaksanaan dunia sebenar | Panduan |
| 08 | Amalan Terbaik untuk MCP | Prestasi, toleransi kesalahan, ketahanan | Panduan |
| 09 | Kajian Kes MCP | Contoh pelaksanaan praktikal | Panduan |
| 10 | Bengkel Praktikal | Membina Pelayan MCP dengan Toolkit AI | Makmal |
| Modul 11: Makmal Praktikal Pelayan MCP | |||
| 11 | Integrasi Pangkalan Data Pelayan MCP | Laluan pembelajaran 13-makmal komprehensif untuk integrasi PostgreSQL | Makmal |
| 11.1 | Pengenalan | Gambaran keseluruhan MCP dengan integrasi pangkalan data dan kes penggunaan analitik runcit | Makmal 00 |
| 11.2 | Seni Bina Teras | Memahami seni bina pelayan MCP, lapisan pangkalan data, dan corak keselamatan | Lab 01 |
| 11.3 | Keselamatan & Multi-Tenancy | Keselamatan Tahap Baris, pengesahan, dan akses data multi-penyewa | Lab 02 |
| 11.4 | Persediaan Persekitaran | Menyediakan persekitaran pembangunan, Docker, sumber Azure | Lab 03 |
| 11.5 | Reka Bentuk Pangkalan Data | Persediaan PostgreSQL, reka bentuk skema runcit, dan data contoh | Lab 04 |
| 11.6 | Pelaksanaan Pelayan MCP | Membina pelayan FastMCP dengan integrasi pangkalan data | Lab 05 |
| 11.7 | Pembangunan Alat | Mencipta alat pertanyaan pangkalan data dan introspeksi skema | Lab 06 |
| 11.8 | Carian Semantik | Melaksanakan vektor embedding dengan Azure OpenAI dan pgvector | Lab 07 |
| 11.9 | Ujian & Penyahpepijatan | Strategi ujian, alat penyahpepijatan, dan pendekatan pengesahan | Lab 08 |
| 11.10 | Integrasi VS Code | Mengkonfigurasi integrasi MCP VS Code dan penggunaan AI Chat | Lab 09 |
| 11.11 | Strategi Penggunaan | Penggunaan Docker, Azure Container Apps, dan pertimbangan penskalaan | Lab 10 |
| 11.12 | Pemantauan | Application Insights, log, pemantauan prestasi | Lab 11 |
| 11.13 | Amalan Terbaik | Pengoptimuman prestasi, pengukuhan keselamatan, dan tip pengeluaran | Lab 12 |
💻 Projek Kod Contoh
Contoh Kalkulator MCP Asas
| Bahasa | Penerangan | Pautan |
|---|---|---|
| C# | Contoh Pelayan MCP | Lihat Kod |
| Java | Kalkulator MCP | Lihat Kod |
| JavaScript | Demo MCP | Lihat Kod |
| Python | Pelayan MCP | Lihat Kod |
| TypeScript | Contoh MCP | Lihat Kod |
| Rust | Contoh MCP | Lihat Kod |
Pelaksanaan MCP Lanjutan
| Bahasa | Penerangan | Pautan |
|---|---|---|
| C# | Contoh Lanjutan | Lihat Kod |
| Java dengan Spring | Contoh Aplikasi Kontena | Lihat Kod |
| JavaScript | Contoh Lanjutan | Lihat Kod |
| Python | Pelaksanaan Kompleks | Lihat Kod |
| TypeScript | Contoh Kontena | Lihat Kod |
🎯 Prasyarat untuk Belajar MCP
Untuk mendapatkan manfaat maksimum daripada kurikulum ini, anda seharusnya mempunyai:
Pengetahuan asas pengaturcaraan dalam sekurang-kurangnya salah satu bahasa berikut: C#, Java, JavaScript, Python, atau TypeScript
Pemahaman tentang model klien-pelayan dan API
Kefahaman tentang konsep REST dan HTTP
(Pilihan) Latar belakang dalam konsep AI/ML
Sertai perbincangan komuniti kami untuk sokongan
📚 Panduan Pembelajaran & Sumber
Repositori ini termasuk beberapa sumber untuk membantu anda belajar dengan berkesan:
Panduan Pembelajaran
Panduan Pembelajaran Study Guide yang komprehensif tersedia untuk membantu anda menavigasi repositori ini dengan berkesan. Panduan ini termasuk:
- Peta kurikulum visual yang menunjukkan semua topik yang diliputi
- Pecahan terperinci setiap bahagian repositori
- Panduan tentang cara menggunakan projek contoh
- Laluan pembelajaran yang disyorkan untuk tahap kemahiran yang berbeza
- Sumber tambahan untuk melengkapkan perjalanan pembelajaran anda
Changelog
Kami menyelenggara Changelog terperinci yang menjejaki semua kemas kini penting kepada bahan kurikulum, termasuk:
- Penambahan kandungan baharu
- Perubahan struktur
- Penambahbaikan ciri
- Kemas kini dokumentasi
🛠️ Cara Menggunakan Kurikulum Ini dengan Berkesan
Setiap pelajaran dalam panduan ini termasuk:
- Penjelasan jelas tentang konsep MCP
- Contoh kod langsung dalam pelbagai bahasa
- Latihan untuk membina aplikasi MCP sebenar
- Sumber tambahan untuk pelajar lanjutan
Acara
MCP Dev Days Julai 2025
➡️Tonton Atas Permintaan - MCP Dev Days
Bersedia untuk dua hari wawasan teknikal mendalam, sambungan komuniti, dan pembelajaran secara langsung di MCP Dev Days, acara maya yang didedikasikan untuk Model Context Protocol (MCP) — standard yang muncul yang menghubungkan model AI dan alat yang mereka gunakan. Anda boleh menonton MCP Dev Days dengan mendaftar di halaman acara kami: https://aka.ms/mcpdevdays.
Hari 1: Produktiviti MCP, Alat Pembangunan, & Komuniti:
Fokus pada memperkasakan pembangun untuk menggunakan MCP dalam aliran kerja pembangunan mereka dan meraikan komuniti MCP yang hebat. Kami akan disertai oleh ahli komuniti dan rakan kongsi seperti Arcade, Block, Okta, dan Neon untuk melihat bagaimana mereka bekerjasama dengan Microsoft untuk membentuk ekosistem MCP yang terbuka dan boleh diperluaskan. Demo dunia sebenar merentasi VS Code, Visual Studio, GitHub Copilot, dan alat komuniti popular Aliran kerja pembangunan yang praktikal dan berasaskan konteks Sesi dan wawasan yang diketuai komuniti Sama ada anda baru bermula dengan MCP atau sudah membina dengannya, Hari 1 akan memberikan inspirasi dan langkah-langkah yang boleh diambil.
Hari 2: Bina Pelayan MCP dengan Keyakinan
Dikhususkan untuk pembina MCP. Kami akan mendalami strategi pelaksanaan dan amalan terbaik untuk mencipta pelayan MCP dan mengintegrasikan MCP ke dalam aliran kerja AI anda.
Topik termasuk:
- Membina Pelayan MCP dan mengintegrasikannya ke dalam pengalaman agen
- Pembangunan berasaskan prompt
- Amalan terbaik keselamatan
- Menggunakan blok binaan seperti Functions, ACA, dan API Management
- Penjajaran registry dan alat (1P + 3P)
Jika anda seorang pembangun, pembina alat, atau ahli strategi produk AI, hari ini penuh dengan wawasan yang anda perlukan untuk membina penyelesaian MCP yang boleh diskala, selamat, dan bersedia untuk masa depan.
MCP Boot Camp Ogos 2025
Belajar dalam sesi video intensif cara mencipta pelayan MCP, mengintegrasi dengan VS Code, dan menggunakan secara profesional di Azure berdasarkan kandungan dari kurikulum MCP untuk Pemula. Dapatkan kemahiran praktikal dalam teknologi yang sudah digunakan oleh syarikat besar.
➡️Tonton Atas Permintaan MCP Bootcamp | Bahasa Inggeris
➡️Tonton Atas Permintaan MCP Bootcamp | Brasil
➡️Tonton Atas Permintaan MCP Bootcamp | Sepanyol
Mari Belajar MCP dengan C# - Siri Tutorial
Mari belajar tentang Model Context Protocol (MCP), rangka kerja terkini yang direka untuk menyeragamkan interaksi antara model AI dan aplikasi klien. Melalui sesi mesra pemula ini, kami akan memperkenalkan anda kepada MCP dan membimbing anda mencipta pelayan MCP pertama anda.
C#: https://aka.ms/letslearnmcp-csharp
Java: https://aka.ms/letslearnmcp-java
JavaScript: https://aka.ms/letslearnmcp-javascript
Python: https://aka.ms/letslearnmcp-python
🌟 Terima Kasih Komuniti
Terima kasih kepada Microsoft Valued Professional Shivam Goyal kerana menyumbang contoh kod penting.
📜 Maklumat Lesen
Kandungan ini dilesenkan di bawah Lesen MIT. Untuk terma dan syarat, lihat LICENSE.
🤝 Garis Panduan Sumbangan
Projek ini mengalu-alukan sumbangan dan cadangan. Kebanyakan sumbangan memerlukan anda bersetuju dengan Perjanjian Lesen Penyumbang (CLA) yang menyatakan bahawa anda mempunyai hak untuk, dan sebenarnya memberikan kami hak untuk menggunakan sumbangan anda. Untuk butiran, lawati https://cla.opensource.microsoft.com.
Apabila anda menghantar permintaan tarik, bot CLA akan secara automatik menentukan sama ada anda perlu memberikan CLA dan menghiasi PR dengan sewajarnya (contohnya, semakan status, komen). Ikuti sahaja arahan yang diberikan oleh bot. Anda hanya perlu melakukan ini sekali untuk semua repositori yang menggunakan CLA kami.
Projek ini telah mengguna pakai Microsoft Open Source Code of Conduct. Untuk maklumat lanjut lihat Code of Conduct FAQ atau hubungi opencode@microsoft.com dengan sebarang soalan atau komen tambahan.
📂 Struktur Repositori
Repositori ini disusun seperti berikut:
- Kurikulum Teras (00-11): Kandungan utama yang disusun dalam sebelas modul berturutan, termasuk makmal integrasi pangkalan data yang komprehensif
- 11-MCPServerHandsOnLabs/: Laluan pembelajaran 13-makmal lengkap untuk membina pelayan MCP yang sedia untuk pengeluaran dengan integrasi PostgreSQL
- images/: Diagram dan ilustrasi yang digunakan sepanjang kurikulum
- translations/: Sokongan pelbagai bahasa dengan terjemahan automatik
- translated_images/: Versi diagram dan ilustrasi yang telah dilokalkan
- study_guide.md: Panduan komprehensif untuk menavigasi repositori
- changelog.md: Rekod semua perubahan penting kepada bahan kurikulum
- mcp.json: Fail konfigurasi untuk spesifikasi MCP
- CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Dokumen tadbir urus projek
🎒 Kursus Lain
Pasukan kami menghasilkan kursus lain! Lihat:
- BARU Edge AI Untuk Pemula
- AI Agents Untuk Pemula
- Generative AI untuk Pemula menggunakan .NET
- Generative AI untuk Pemula menggunakan JavaScript
- Generative AI untuk Pemula
- Generative AI untuk Pemula menggunakan Java
- ML untuk Pemula
- Data Science untuk Pemula
- AI untuk Pemula
- Keselamatan Siber untuk Pemula
- Web Dev untuk Pemula
- IoT untuk Pemula
- Pembangunan XR untuk Pemula
- Menguasai GitHub Copilot untuk Pengaturcaraan Berpasangan AI
- Menguasai GitHub Copilot untuk Pembangun C#/.NET
- Pilih Pengembaraan Copilot Anda Sendiri
™️ Notis Tanda Dagangan
Projek ini mungkin mengandungi tanda dagangan atau logo untuk projek, produk, atau perkhidmatan. Penggunaan tanda dagangan atau logo Microsoft yang dibenarkan mesti mematuhi dan mengikuti Panduan Tanda Dagangan & Jenama Microsoft. Penggunaan tanda dagangan atau logo Microsoft dalam versi yang diubah suai projek ini tidak boleh menyebabkan kekeliruan atau menyiratkan penajaan oleh Microsoft. Sebarang penggunaan tanda dagangan atau logo pihak ketiga adalah tertakluk kepada dasar pihak ketiga tersebut.
Mendapatkan Bantuan
Jika anda menghadapi kesukaran atau mempunyai soalan tentang membina aplikasi AI, sertai:
Jika anda mempunyai maklum balas produk atau menghadapi ralat semasa membina, lawati:
Penafian:
Dokumen ini telah diterjemahkan menggunakan perkhidmatan terjemahan AI Co-op Translator. Walaupun kami berusaha untuk memastikan ketepatan, sila ambil perhatian bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya harus dianggap sebagai sumber yang berwibawa. Untuk maklumat yang kritikal, terjemahan manusia profesional adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini.