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 berikut untuk memulai menggunakan sumber daya ini:

  1. Fork Repository: Klik GitHub forks
  2. Clone Repository: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Bergabung dengan Azure AI Foundry Discord dan temui para ahli serta sesama pengembang

🌐 Dukungan Multi-Bahasa

Didukung melalui GitHub Action (Otomatis & Selalu Terbaru)

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

Pelajari MCP dengan Contoh Kode Praktis dalam C#, Java, JavaScript, Python, dan TypeScript

🧠 Gambaran Umum Kurikulum Model Context Protocol

Model Context Protocol (MCP) adalah kerangka kerja mutakhir yang dirancang untuk menstandarisasi interaksi antara model AI dan aplikasi klien. Kurikulum open-source ini menawarkan jalur pembelajaran terstruktur, lengkap dengan contoh kode praktis dan kasus penggunaan nyata, dalam bahasa pemrograman populer seperti C#, Java, JavaScript, TypeScript, dan Python.

Apakah Anda seorang pengembang AI, arsitek sistem, atau insinyur perangkat lunak, panduan ini adalah sumber lengkap untuk menguasai dasar-dasar MCP dan strategi implementasinya.

🔗 Sumber Resmi MCP

Bergabunglah dalam MCP Dev Days 29-30 Juli 2025

Bersiaplah untuk dua hari penuh wawasan teknis mendalam, koneksi komunitas, dan pembelajaran langsung di MCP Dev Days, sebuah acara virtual yang didedikasikan untuk Model Context Protocol (MCP) — standar baru yang menghubungkan model AI dan alat yang mereka gunakan.

➡️ Daftar untuk MCP Dev Days

Anda dapat menonton MCP Dev Days dengan mendaftar di halaman acara kami: https://aka.ms/mcpdevdays. Dari sana, Anda bisa bergabung dengan siaran langsung di YouTube atau Twitch. Semua konten direkam dan akan tersedia setelahnya di saluran Microsoft Developer YouTube. Kode sumber untuk demo juga akan tersedia di GitHub.

Detail Acara

  • Tanggal: 29 Juli (Hari 1) & 30 Juli (Hari 2)
  • Waktu: 9:00 AM PST setiap hari
  • Tempat: Online – bisa diikuti dari mana saja!

Hari 1: Produktivitas MCP, DevTools, & Komunitas

Fokus pada pemberdayaan pengembang untuk menggunakan MCP dalam alur kerja mereka dan merayakan komunitas MCP yang luar biasa. Kami akan bergabung dengan anggota komunitas dan mitra seperti Arcade, Block, Okta, dan Neon untuk melihat bagaimana mereka berkolaborasi dengan Microsoft membentuk ekosistem MCP yang terbuka dan dapat diperluas. Demo nyata di VS Code, Visual Studio, GitHub Copilot, dan alat komunitas populer
Alur kerja pengembangan yang praktis dan berbasis konteks
Sesi dan wawasan yang dipimpin oleh komunitas
Apakah Anda baru mulai dengan MCP atau sudah membangunnya, Hari 1 akan memberikan inspirasi dan langkah-langkah yang bisa langsung diterapkan.

Hari 2: Bangun Server MCP dengan Percaya Diri

Didedikasikan untuk pembangun MCP. Kami akan membahas strategi implementasi dan praktik terbaik untuk membuat server MCP dan mengintegrasikan MCP ke dalam alur kerja AI Anda.

Topik yang dibahas:

  • Membangun Server MCP dan mengintegrasikannya ke pengalaman agen
  • Pengembangan berbasis prompt
  • Praktik terbaik keamanan
  • Menggunakan blok bangunan seperti Functions, ACA, dan API Management
  • Penyelarasan registry dan alat (1P + 3P)

Jika Anda seorang pengembang, pembuat alat, atau strategis produk AI, hari ini penuh dengan wawasan yang Anda butuhkan untuk membangun solusi MCP yang skalabel, aman, dan siap masa depan.

🧭 Gambaran Kurikulum MCP

📚 Struktur Kurikulum Lengkap

Modul Topik Deskripsi Tautan
Modul 1-3: Dasar-dasar
00 Pengenalan MCP Gambaran umum Model Context Protocol dan pentingnya dalam pipeline AI Baca selengkapnya
01 Penjelasan Konsep Inti Eksplorasi mendalam tentang konsep inti MCP Baca selengkapnya
02 Keamanan dalam MCP Ancaman keamanan dan praktik terbaik Baca selengkapnya
03 Memulai dengan MCP Pengaturan lingkungan, server/klien dasar, integrasi Baca selengkapnya
Modul 3: Membangun Server & Klien Pertama Anda
3.1 Server Pertama Membuat server MCP pertama Anda Panduan
3.2 Klien Pertama Mengembangkan klien MCP dasar Panduan
3.3 Klien dengan LLM Mengintegrasikan model bahasa besar Panduan
3.4 Integrasi VS Code Menggunakan server MCP di VS Code Panduan
3.5 Server SSE Membuat server menggunakan Server-Sent Events Panduan
3.6 HTTP Streaming Menerapkan streaming HTTP dalam MCP Panduan
3.7 AI Toolkit Menggunakan AI Toolkit dengan MCP Panduan
3.8 Pengujian Menguji implementasi server MCP Anda Panduan
3.9 Deployment Mendeploy server MCP ke produksi Panduan
Modul 4-5: Praktis & Lanjutan
04 Implementasi Praktis SDK, debugging, pengujian, template prompt yang dapat digunakan ulang Baca selengkapnya
05 Topik Lanjutan dalam MCP AI multi-modal, scaling, penggunaan enterprise Baca selengkapnya
5.1 Integrasi Azure Integrasi MCP dengan Azure Panduan
5.2 Multi-modality Bekerja dengan berbagai modalitas Panduan
5.3 Demo OAuth2 Menerapkan autentikasi OAuth2 Panduan
5.4 Root Contexts Memahami dan mengimplementasikan root contexts Panduan
5.5 Routing Strategi routing MCP Panduan
5.6 Sampling Teknik sampling dalam MCP Panduan
5.7 Scaling Meningkatkan skala implementasi MCP Panduan
5.8 Keamanan Pertimbangan keamanan lanjutan Panduan
5.9 Pencarian Web Menerapkan kemampuan pencarian web Panduan
5.10 Streaming Realtime Membangun fungsi streaming realtime Panduan
5.11 Pencarian Realtime Menerapkan pencarian realtime Panduan
5.12 Entra ID Auth Otentikasi dengan Microsoft Entra ID Panduan
5.13 Integrasi Foundry Integrasi dengan Azure AI Foundry Panduan
5.14 Rekayasa Konteks Teknik untuk rekayasa konteks yang efektif Panduan
Modul 6-10: Komunitas & Praktik Terbaik
06 Kontribusi Komunitas Cara berkontribusi ke ekosistem MCP Panduan
07 Wawasan dari Adopsi Awal Kisah implementasi di dunia nyata Panduan
08 Praktik Terbaik untuk MCP Performa, toleransi kesalahan, ketahanan Panduan
09 Studi Kasus MCP Contoh implementasi praktis Panduan
10 Workshop Praktik Membangun MCP Server dengan AI Toolkit Lab

💻 Contoh Proyek Kode

Contoh Dasar Kalkulator MCP

Bahasa Deskripsi Tautan
C# Contoh MCP Server Lihat Kode
Java Kalkulator MCP Lihat Kode
JavaScript Demo MCP Lihat Kode
Python MCP Server Lihat Kode
TypeScript Contoh MCP Lihat Kode

Implementasi Lanjutan MCP

Bahasa Deskripsi Tautan
C# Contoh Lanjutan Lihat Kode
Java Contoh Aplikasi Container Lihat Kode
JavaScript Contoh Lanjutan Lihat Kode
Python Implementasi Kompleks Lihat Kode
TypeScript Contoh Container Lihat Kode

🎯 Prasyarat untuk Belajar MCP

Agar bisa mendapatkan manfaat maksimal dari kurikulum ini, Anda sebaiknya memiliki:

  • Pengetahuan dasar pemrograman dalam minimal salah satu bahasa berikut: C#, Java, JavaScript, Python, atau TypeScript

  • Pemahaman tentang model client-server dan API

  • Familiar dengan konsep REST dan HTTP

  • (Opsional) Latar belakang konsep AI/ML

  • Bergabung dalam diskusi komunitas kami untuk dukungan

📚 Panduan Belajar & Sumber Daya

Repositori ini menyediakan beberapa sumber daya untuk membantu Anda belajar dengan efektif:

Panduan Belajar

Tersedia Panduan Belajar yang komprehensif untuk membantu Anda menavigasi repositori ini dengan baik. Panduan ini mencakup:

  • Peta kurikulum visual yang menunjukkan semua topik yang dibahas
  • Rincian setiap bagian repositori
  • Panduan penggunaan proyek contoh
  • Jalur pembelajaran yang direkomendasikan untuk berbagai tingkat keahlian
  • Sumber tambahan untuk melengkapi perjalanan belajar Anda

Changelog

Kami memelihara Changelog yang mendokumentasikan semua pembaruan penting pada materi kurikulum, termasuk:

  • Penambahan konten baru
  • Perubahan struktur
  • Peningkatan fitur
  • Pembaruan dokumentasi

🛠️ Cara Menggunakan Kurikulum Ini dengan Efektif

Setiap pelajaran dalam panduan ini mencakup:

  1. Penjelasan konsep MCP yang jelas
  2. Contoh kode langsung dalam berbagai bahasa
  3. Latihan untuk membangun aplikasi MCP nyata
  4. Sumber tambahan untuk pembelajar tingkat lanjut

🌟 Ucapan Terima Kasih Komunitas

Terima kasih kepada Microsoft Valued Professional Shivam Goyal atas kontribusinya dalam menyediakan contoh kode penting.

📜 Informasi Lisensi

Konten ini dilisensikan di bawah MIT License. Untuk syarat dan ketentuan, lihat LICENSE.

🤝 Panduan Kontribusi

Proyek ini menyambut kontribusi dan saran. Sebagian besar kontribusi mengharuskan Anda menyetujui
Contributor License Agreement (CLA) yang menyatakan bahwa Anda memiliki hak dan benar-benar memberikan
kami hak untuk menggunakan kontribusi Anda. Untuk detail, kunjungi
https://cla.opensource.microsoft.com.

Saat Anda mengirimkan pull request, bot CLA akan secara otomatis menentukan apakah Anda perlu menyediakan
CLA dan menandai PR dengan tepat (misalnya, pemeriksaan status, komentar). Cukup ikuti instruksi
yang diberikan oleh bot. Anda hanya perlu melakukan ini sekali untuk semua repositori yang menggunakan CLA kami.

Proyek ini mengadopsi Microsoft Open Source Code of Conduct.
Untuk informasi lebih lanjut, lihat Code of Conduct FAQ atau
hubungi opencode@microsoft.com untuk pertanyaan atau komentar tambahan.

📂 Struktur Repositori

Repositori ini diatur sebagai berikut:

  • Kurikulum Inti (00-10): Konten utama yang disusun dalam sepuluh modul berurutan
  • images/: Diagram dan ilustrasi yang digunakan sepanjang kurikulum
  • translations/: Dukungan multi-bahasa dengan terjemahan otomatis
  • translated_images/: Versi lokal dari diagram dan ilustrasi
  • study_guide.md: Panduan lengkap untuk menavigasi repositori
  • changelog.md: Catatan semua perubahan penting pada materi kurikulum
  • mcp.json: File konfigurasi untuk spesifikasi MCP
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Dokumen tata kelola proyek

🎒 Kursus Lainnya

Tim kami juga membuat kursus lain! Cek di:

™️ Pemberitahuan Merek Dagang

Proyek ini mungkin berisi merek dagang atau logo untuk proyek, produk, atau layanan. Penggunaan merek dagang atau logo Microsoft yang sah harus mematuhi dan mengikuti
Microsoft's Trademark & Brand Guidelines.
Penggunaan merek dagang atau logo Microsoft dalam versi modifikasi dari proyek ini tidak boleh menimbulkan kebingungan atau menyiratkan sponsor Microsoft.
Setiap penggunaan merek dagang atau logo pihak ketiga tunduk pada kebijakan pihak ketiga tersebut.

Penafian:
Dokumen ini telah diterjemahkan menggunakan layanan terjemahan AI Co-op Translator. Meskipun kami berupaya untuk akurasi, harap diketahui bahwa terjemahan otomatis mungkin mengandung kesalahan atau ketidakakuratan. Dokumen asli dalam bahasa aslinya harus dianggap sebagai sumber yang sah. Untuk informasi penting, disarankan menggunakan terjemahan profesional oleh manusia. Kami tidak bertanggung jawab atas kesalahpahaman atau penafsiran yang salah yang timbul dari penggunaan terjemahan ini.