Skip to content

Latest commit

 

History

History
263 lines (193 loc) · 19 KB

File metadata and controls

263 lines (193 loc) · 19 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Ikuti langkah-langkah ini untuk mula menggunakan sumber ini:

  1. Fork Repositori: Klik GitHub forks
  2. Clone Repositori: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Sertai Azure AI Foundry Discord dan berjumpa dengan pakar serta pembangun lain

🌐 Sokongan Pelbagai Bahasa

Disokong melalui GitHub Action (Automatik & Sentiasa Dikemas Kini)

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)

🚀 Kurikulum Model Context Protocol (MCP) untuk Pemula

Belajar MCP dengan Contoh Kod Praktikal dalam C#, Java, JavaScript, Python, dan TypeScript

🧠 Gambaran Keseluruhan Kurikulum Model Context Protocol

Model Context Protocol (MCP) adalah rangka kerja terkini yang direka untuk menstandardkan interaksi antara model AI dan aplikasi klien. Kurikulum sumber terbuka ini menawarkan laluan pembelajaran yang tersusun, lengkap dengan contoh kod praktikal dan kes penggunaan 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 lengkap anda untuk menguasai asas dan strategi pelaksanaan MCP.

🔗 Sumber Rasmi MCP

Sertai kami untuk MCP Dev Days 29-30 Julai 2025

Bersiaplah untuk dua hari penuh dengan wawasan teknikal mendalam, hubungan komuniti, dan pembelajaran praktikal di MCP Dev Days, acara maya yang didedikasikan untuk Model Context Protocol (MCP) — standard baru yang menghubungkan model AI dan alat yang mereka gunakan.

➡️ Daftar untuk MCP Dev Days

Anda boleh menonton MCP Dev Days dengan mendaftar di halaman acara kami: https://aka.ms/mcpdevdays. Dari situ, anda boleh menyertai siaran langsung di YouTube atau Twitch. Semua kandungan dirakam dan akan tersedia selepas itu di saluran YouTube Microsoft Developer. Kod sumber untuk demo juga akan tersedia di GitHub.

Butiran Acara

  • Tarikh: 29 Julai (Hari 1) & 30 Julai (Hari 2)
  • Masa: 9:00 AM PST setiap hari
  • Lokasi: Dalam talian – sertai dari mana-mana sahaja!

Hari 1: Produktiviti MCP, DevTools, & Komuniti:

Fokus pada memperkasakan pembangun menggunakan MCP dalam aliran kerja pembangunan mereka dan meraikan komuniti MCP yang hebat. Kami akan bersama ahli komuniti dan rakan kongsi seperti Arcade, Block, Okta, dan Neon untuk melihat bagaimana mereka bekerjasama dengan Microsoft membentuk ekosistem MCP yang terbuka dan boleh dikembangkan. Demo dunia sebenar merangkumi VS Code, Visual Studio, GitHub Copilot, dan alat komuniti popular
Aliran kerja pembangunan berasaskan konteks yang praktikal
Sesi dan pandangan yang dipimpin oleh komuniti
Sama ada anda baru bermula dengan MCP atau sudah membangunnya, Hari 1 akan menyediakan inspirasi dan langkah yang boleh diambil.

Hari 2: Bina Server MCP dengan Keyakinan

Didedikasikan untuk pembina MCP. Kami akan mendalami strategi pelaksanaan dan amalan terbaik untuk mencipta server MCP dan mengintegrasikan MCP ke dalam aliran kerja AI anda.

Topik termasuk:

  • Membina Server MCP dan mengintegrasikannya ke dalam pengalaman agen
  • Pembangunan berasaskan prompt
  • Amalan keselamatan terbaik
  • Menggunakan blok binaan seperti Functions, ACA, dan Pengurusan API
  • Penyelarasan registry dan alat (1P + 3P)

Jika anda seorang pembangun, pembina alat, atau perancang produk AI, hari ini penuh dengan wawasan yang anda perlukan untuk membina penyelesaian MCP yang boleh diskala, selamat, dan bersedia untuk masa depan.

🧭 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 Penerangan 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, server/klien asas, integrasi Baca lebih lanjut
Modul 3: Membina Server & Klien Pertama Anda
3.1 Server Pertama Cipta server 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 Gunakan server MCP dalam VS Code Panduan
3.5 Server SSE Cipta server menggunakan Server-Sent Events Panduan
3.6 Penstriman HTTP Laksanakan penstriman HTTP dalam MCP Panduan
3.7 AI Toolkit Gunakan AI Toolkit dengan MCP Panduan
3.8 Ujian Uji pelaksanaan server MCP anda Panduan
3.9 Pengeluaran Lancarkan server MCP ke produksi Panduan
Modul 4-5: Praktikal & Lanjutan
04 Pelaksanaan Praktikal SDK, penyahpepijatan, ujian, templat prompt boleh guna 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 Root Contexts Fahami dan laksanakan konteks akar Panduan
5.5 Routing Strategi routing MCP Panduan
5.6 Sampling Teknik sampling 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 Entra ID Auth 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
Modul 6-10: Komuniti & Amalan Terbaik
06 Sumbangan Komuniti Cara menyumbang kepada ekosistem MCP Panduan
07 Wawasan dari Penggunaan Awal Kisah pelaksanaan sebenar Panduan
08 Amalan Terbaik untuk MCP Prestasi, ketahanan ralat, daya tahan Panduan
09 Kajian Kes MCP Contoh pelaksanaan praktikal Panduan
10 Bengkel Praktikal Membina Server MCP dengan AI Toolkit Makmal

💻 Projek Kod Contoh

Contoh Kalkulator MCP Asas

Bahasa Penerangan Pautan
C# Contoh Server MCP Lihat Kod
Java Kalkulator MCP Lihat Kod
JavaScript Demo MCP Lihat Kod
Python Server MCP Lihat Kod
TypeScript Contoh MCP Lihat Kod

Pelaksanaan MCP Lanjutan

Bahasa Penerangan Pautan
C# Contoh Lanjutan Lihat Kod
Java Contoh Aplikasi Kontena Lihat Kod
JavaScript Contoh Lanjutan Lihat Kod
Python Pelaksanaan Kompleks Lihat Kod
TypeScript Contoh Kontena Lihat Kod

🎯 Prasyarat untuk Mempelajari MCP

Untuk mendapatkan manfaat maksimum daripada kurikulum ini, anda perlu mempunyai:

  • Pengetahuan asas pengaturcaraan dalam sekurang-kurangnya satu daripada bahasa berikut: C#, Java, JavaScript, Python, atau TypeScript

  • Kefahaman tentang model klien-pelayan dan API

  • Kebiasaan dengan konsep REST dan HTTP

  • (Pilihan) Latar belakang dalam konsep AI/ML

  • Menyertai perbincangan komuniti kami untuk sokongan

📚 Panduan & Sumber Pembelajaran

Repositori ini mengandungi beberapa sumber untuk membantu anda menavigasi dan belajar dengan berkesan:

Panduan Pembelajaran

Satu Panduan Pembelajaran yang komprehensif disediakan untuk membantu anda menavigasi repositori ini dengan berkesan. Panduan ini merangkumi:

  • Peta kurikulum visual yang menunjukkan semua topik yang diliputi
  • Pecahan terperinci setiap bahagian repositori
  • Panduan cara menggunakan projek contoh
  • Laluan pembelajaran yang disyorkan untuk pelbagai tahap kemahiran
  • Sumber tambahan untuk melengkapkan perjalanan pembelajaran anda

Changelog

Kami mengekalkan Changelog yang terperinci untuk menjejaki semua kemas kini penting pada bahan kurikulum, termasuk:

  • Penambahan kandungan baru
  • Perubahan struktur
  • Penambahbaikan ciri
  • Kemas kini dokumentasi

🛠️ Cara Menggunakan Kurikulum Ini dengan Berkesan

Setiap pelajaran dalam panduan ini merangkumi:

  1. Penjelasan jelas tentang konsep MCP
  2. Contoh kod langsung dalam pelbagai bahasa
  3. Latihan untuk membina aplikasi MCP sebenar
  4. Sumber tambahan untuk pelajar lanjutan

🌟 Penghargaan Komuniti

Terima kasih kepada Microsoft Valued Professional Shivam Goyal atas sumbangan 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 benar-benar memberi, hak kepada kami untuk menggunakan sumbangan anda. Untuk maklumat lanjut, lawati https://cla.opensource.microsoft.com.

Apabila anda menghantar permintaan tarik, bot CLA akan secara automatik menentukan sama ada anda perlu menyediakan CLA dan menghias PR dengan sewajarnya (contohnya, pemeriksaan status, komen). Ikuti sahaja arahan yang diberikan oleh bot. Anda hanya perlu melakukan ini sekali sahaja untuk semua repositori yang menggunakan CLA kami.

Projek ini telah mengamalkan Kod Etika Sumber Terbuka Microsoft. Untuk maklumat lanjut, lihat Soalan Lazim Kod Etika atau hubungi opencode@microsoft.com untuk sebarang soalan atau komen tambahan.

📂 Struktur Repositori

Repositori disusun seperti berikut:

  • Kurikulum Teras (00-10): Kandungan utama yang disusun dalam sepuluh modul berturutan
  • images/: Rajah dan ilustrasi yang digunakan sepanjang kurikulum
  • translations/: Sokongan pelbagai bahasa dengan terjemahan automatik
  • translated_images/: Versi terjemahan rajah dan ilustrasi
  • study_guide.md: Panduan komprehensif untuk menavigasi repositori
  • changelog.md: Rekod semua perubahan penting pada 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:

™️ Notis Tanda Dagangan

Projek ini mungkin mengandungi tanda dagangan atau logo untuk projek, produk, atau perkhidmatan. Penggunaan sah tanda dagangan atau logo Microsoft tertakluk kepada dan mesti mematuhi Microsoft's Trademark & Brand Guidelines. Penggunaan tanda dagangan atau logo Microsoft dalam versi projek yang diubah suai tidak boleh menyebabkan kekeliruan atau memberi gambaran bahawa Microsoft menaja projek tersebut. Sebarang penggunaan tanda dagangan atau logo pihak ketiga tertakluk kepada polisi pihak ketiga tersebut.

Penafian:
Dokumen ini telah diterjemahkan menggunakan perkhidmatan terjemahan AI Co-op Translator. Walaupun kami berusaha untuk ketepatan, sila ambil maklum bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya harus dianggap sebagai sumber yang sahih. Untuk maklumat penting, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini.