Skip to content

Latest commit

 

History

History
266 lines (199 loc) · 19.8 KB

File metadata and controls

266 lines (199 loc) · 19.8 KB

MCP-untuk-pemula

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Ikuti langkah-langkah berikut 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 Discord Azure AI Foundry dan berhubung dengan pakar serta pembangun lain

🌐 Sokongan Pelbagai Bahasa

Disokong melalui GitHub Action (Automatik & Sentiasa Terkini)

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

🚀 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) ialah 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 anda untuk menguasai asas MCP dan strategi pelaksanaannya.

🔗 Sumber Rasmi MCP

🧭 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 Bermula dengan 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
Modul 4-5: Praktikal & Lanjutan
04 Pelaksanaan Praktikal SDK, debugging, 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-modality 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
Modul 6-10: Komuniti & Amalan Terbaik
06 Sumbangan Komuniti Cara menyumbang kepada ekosistem MCP Panduan
07 Pandangan daripada Pengguna 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

💻 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 View Code
Java dengan Spring Contoh Aplikasi Container View Code
JavaScript Contoh Lanjutan View Code
Python Implementasi Kompleks View Code
TypeScript Contoh Container View Code

🎯 Prasyarat untuk Belajar MCP

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

  • Pengetahuan asas tentang 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 Belajar & Sumber

Repositori ini termasuk beberapa sumber untuk membantu anda belajar dengan berkesan:

Panduan Belajar

Panduan Belajar 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 sampel
  • 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:

  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

Acara

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 sedang berkembang 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.

Fokus pada memperkasakan pembangun untuk menggunakan MCP dalam aliran kerja mereka dan meraikan komuniti MCP yang luar biasa. 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 diperluas. 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 panduan yang boleh diambil tindakan.

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 diskalakan, 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 melancarkan secara profesional di Azure berdasarkan kandungan daripada kurikulum MCP untuk Pemula. Dapatkan kemahiran praktikal dalam teknologi yang sudah digunakan oleh syarikat besar.

🌟 Terima Kasih Komuniti

Terima kasih kepada Microsoft Valued Professional Shivam Goyal kerana menyumbang sampel kod penting.

📜 Maklumat Lesen

Kandungan ini dilesenkan di bawah MIT License. Untuk terma dan syarat, lihat LICENSE.

🤝 Garis Panduan Sumbangan

Projek ini mengalu-alukan sumbangan dan cadangan. Kebanyakan sumbangan memerlukan anda bersetuju dengan Contributor License Agreement (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 menghias PR dengan sewajarnya (contohnya, pemeriksaan 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 mengadopsi 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-10): Kandungan utama yang disusun dalam sepuluh modul berturutan
  • images/: Diagram dan ilustrasi yang digunakan sepanjang kurikulum
  • translations/: Sokongan pelbagai bahasa dengan terjemahan automatik
  • translated_images/: Versi lokal diagram dan ilustrasi
  • 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:

™️ Notis Tanda Dagangan

Projek ini mungkin mengandungi tanda dagangan atau logo untuk projek, produk, atau perkhidmatan. Penggunaan yang dibenarkan untuk tanda dagangan atau logo Microsoft mesti mematuhi dan mengikuti Microsoft's Trademark & Brand Guidelines. 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 mesti mematuhi dasar pihak ketiga tersebut.


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.