Skip to content

Latest commit

 

History

History
263 lines (193 loc) · 20.2 KB

File metadata and controls

263 lines (193 loc) · 20.2 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Sundin ang mga hakbang na ito para makapagsimula gamit ang mga resources na ito:

  1. I-fork ang Repository: I-click ang GitHub forks
  2. I-clone ang Repository: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Sumali sa Azure AI Foundry Discord at makipagkilala sa mga eksperto at kapwa developer

🌐 Suporta sa Maramihang Wika

Sinusuportahan sa pamamagitan ng GitHub Action (Awtomatiko at Palaging Napapanahon)

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 ng Model Context Protocol (MCP) para sa mga Baguhan

Matutunan ang MCP gamit ang mga Praktikal na Halimbawa ng Code sa C#, Java, JavaScript, Python, at TypeScript

🧠 Pangkalahatang-ideya ng Kurikulum ng Model Context Protocol

Ang Model Context Protocol (MCP) ay isang makabagong framework na idinisenyo upang gawing pare-pareho ang ugnayan sa pagitan ng mga AI model at mga client application. Ang bukas na kurikulum na ito ay nag-aalok ng isang maayos na landas ng pag-aaral, kumpleto sa mga praktikal na halimbawa ng coding at mga totoong gamit, sa mga kilalang programming language tulad ng C#, Java, JavaScript, TypeScript, at Python.

Kung ikaw man ay isang AI developer, system architect, o software engineer, ang gabay na ito ang iyong kumpletong sanggunian para maunawaan ang mga pundasyon ng MCP at mga estratehiya sa pagpapatupad nito.

🔗 Opisyal na Mga Resource ng MCP

Sumali sa MCP Dev Days sa Hulyo 29-30, 2025

Maghanda para sa dalawang araw ng malalim na teknikal na kaalaman, pakikipag-ugnayan sa komunidad, at praktikal na pag-aaral sa MCP Dev Days, isang virtual na kaganapan na nakatuon sa Model Context Protocol (MCP) — ang bagong pamantayan na nag-uugnay sa mga AI model at mga tool na kanilang ginagamit.

➡️ Magparehistro para sa MCP Dev Days

Puwede mong panoorin ang MCP Dev Days sa pamamagitan ng pagrerehistro sa aming pahina ng kaganapan: https://aka.ms/mcpdevdays. Mula doon, makakasali ka sa live stream sa YouTube o Twitch. Lahat ng nilalaman ay nire-record at magiging available pagkatapos sa Microsoft Developer YouTube channel. Ang source code para sa mga demo ay makikita rin sa GitHub.

Detalye ng Kaganapan

  • Mga Petsa: Hulyo 29 (Araw 1) at Hulyo 30 (Araw 2)
  • Oras: 9:00 AM PST araw-araw
  • Saan: Online – puwedeng sumali mula saanman!

Araw 1: MCP Productivity, DevTools, at Komunidad:

Nakatuon ito sa pagbibigay kapangyarihan sa mga developer na gamitin ang MCP sa kanilang workflow at pagdiriwang ng kahanga-hangang MCP community. Sasamahan tayo ng mga miyembro ng komunidad at mga partner tulad ng Arcade, Block, Okta, at Neon upang makita kung paano sila nakikipagtulungan sa Microsoft para bumuo ng isang bukas at extensible na MCP ecosystem. Mga totoong demo gamit ang VS Code, Visual Studio, GitHub Copilot, at mga sikat na community tools
Praktikal at kontekstong workflow para sa mga developer
Mga sesyon at insight na pinangungunahan ng komunidad
Kung nagsisimula ka pa lang sa MCP o aktibong gumagamit na nito, ang Araw 1 ay magbibigay ng inspirasyon at mga konkretong hakbang.

Araw 2: Magtayo ng MCP Servers nang May Kumpiyansa

Para ito sa mga tagabuo ng MCP. Tatalakayin natin nang malalim ang mga estratehiya sa pagpapatupad at mga pinakamahusay na kasanayan sa paggawa ng MCP servers at pagsasama ng MCP sa iyong AI workflows.

Mga Paksa:

  • Paggawa ng MCP Servers at pagsasama nito sa mga karanasan ng agent
  • Prompt-driven development
  • Mga pinakamahusay na kasanayan sa seguridad
  • Paggamit ng mga building blocks tulad ng Functions, ACA, at API Management
  • Pag-align ng registry at mga tool (1P + 3P)

Kung ikaw ay developer, tagagawa ng tool, o AI product strategist, puno ang araw na ito ng mga insight na kailangan mo para makabuo ng scalable, secure, at handang-handa sa hinaharap na MCP solutions.

🧭 Pangkalahatang-ideya ng Kurikulum ng MCP

📚 Kumpletong Estruktura ng Kurikulum

Module Paksa Paglalarawan Link
Module 1-3: Mga Pundamental
00 Panimula sa MCP Pangkalahatang ideya ng Model Context Protocol at ang kahalagahan nito sa AI pipelines Basahin pa
01 Paliwanag sa Mga Pangunahing Konsepto Malalim na pagtalakay sa mga pangunahing konsepto ng MCP Basahin pa
02 Seguridad sa MCP Mga banta sa seguridad at pinakamahusay na mga kasanayan Basahin pa
03 Pagsisimula sa MCP Pagsasaayos ng kapaligiran, mga basic na server/client, integrasyon Basahin pa
Module 3: Pagtatayo ng Iyong Unang Server at Client
3.1 Unang Server Gumawa ng iyong unang MCP server Gabay
3.2 Unang Client Bumuo ng isang basic na MCP client Gabay
3.3 Client na may LLM Isama ang malalaking language model Gabay
3.4 Integrasyon sa VS Code Gamitin ang MCP servers sa VS Code Gabay
3.5 SSE Server Gumawa ng mga server gamit ang Server-Sent Events Gabay
3.6 HTTP Streaming Ipatupad ang HTTP streaming sa MCP Gabay
3.7 AI Toolkit Gamitin ang AI Toolkit kasama ang MCP Gabay
3.8 Pagsusuri Subukan ang iyong implementasyon ng MCP server Gabay
3.9 Deployment I-deploy ang MCP servers sa production Gabay
Module 4-5: Praktikal at Advanced
04 Praktikal na Pagpapatupad SDKs, debugging, testing, reusable prompt templates Basahin pa
05 Mga Advanced na Paksa sa MCP Multi-modal AI, scaling, paggamit sa enterprise Basahin pa
5.1 Integrasyon sa Azure MCP Integration sa Azure Gabay
5.2 Multi-modality Paggamit ng maraming modality Gabay
5.3 OAuth2 Demo Pagpapatupad ng OAuth2 authentication Gabay
5.4 Root Contexts Unawain at ipatupad ang root contexts Gabay
5.5 Routing Mga estratehiya sa MCP routing Gabay
5.6 Sampling Mga teknik sa sampling sa MCP Gabay
5.7 Scaling I-scale ang mga implementasyon ng MCP Gabay
5.8 Seguridad Mga advanced na konsiderasyon sa seguridad Gabay
5.9 Web Search Ipatupad ang kakayahan sa web search Gabay
5.10 Realtime Streaming Bumuo ng realtime streaming functionality Gabay
5.11 Realtime Search Ipatupad ang realtime search Gabay
5.12 Entra ID Auth Pagpapatunay gamit ang Microsoft Entra ID Guide
5.13 Foundry Integration Pagsasama sa Azure AI Foundry Guide
5.14 Context Engineering Mga teknik para sa epektibong context engineering Guide
Module 6-10: Community & Best Practices
06 Mga Ambag ng Komunidad Paano makapag-ambag sa MCP ecosystem Guide
07 Mga Aral mula sa Maagang Paggamit Mga kwento ng aktwal na implementasyon Guide
08 Mga Pinakamahusay na Gawi para sa MCP Performance, fault-tolerance, resilience Guide
09 Mga Kaso ng Pag-aaral ng MCP Mga praktikal na halimbawa ng implementasyon Guide
10 Hands-on Workshop Paggawa ng MCP Server gamit ang AI Toolkit Lab

💻 Mga Halimbawang Proyekto ng Code

Mga Pangunahing Halimbawa ng MCP Calculator

Wika Paglalarawan Link
C# Halimbawa ng MCP Server View Code
Java MCP Calculator View Code
JavaScript MCP Demo View Code
Python MCP Server View Code
TypeScript Halimbawa ng MCP View Code

Mga Advanced na Implementasyon ng MCP

Wika Paglalarawan Link
C# Advanced na Halimbawa View Code
Java Halimbawa ng Container App View Code
JavaScript Advanced na Halimbawa View Code
Python Masalimuot na Implementasyon View Code
TypeScript Halimbawa ng Container View Code

🎯 Mga Kinakailangan para sa Pag-aaral ng MCP

Para masulit ang kurikulum na ito, dapat mayroon kang:

  • Pangunahing kaalaman sa programming sa kahit isa sa mga sumusunod na wika: C#, Java, JavaScript, Python, o TypeScript

  • Pag-unawa sa client-server model at APIs

  • Pamilyar sa mga konsepto ng REST at HTTP

  • (Opsyonal) Kaalaman sa mga konsepto ng AI/ML

  • Pagsali sa mga talakayan ng aming komunidad para sa suporta

📚 Gabay sa Pag-aaral at Mga Mapagkukunan

Kasama sa repositoryong ito ang ilang mga mapagkukunan upang matulungan kang mag-navigate at matuto nang epektibo:

Gabay sa Pag-aaral

Mayroon kaming komprehensibong Study Guide upang gabayan ka sa paggamit ng repositoryong ito nang maayos. Kasama sa gabay ang:

  • Isang visual na mapa ng kurikulum na nagpapakita ng lahat ng mga paksang sakop
  • Detalyadong paghahati-hati ng bawat seksyon ng repositoryo
  • Patnubay kung paano gamitin ang mga sample na proyekto
  • Inirekomendang mga landas sa pag-aaral para sa iba't ibang antas ng kasanayan
  • Karagdagang mga mapagkukunan upang suportahan ang iyong paglalakbay sa pag-aaral

Changelog

Pinapanatili namin ang detalyadong Changelog na nagtatala ng lahat ng mahahalagang update sa mga materyales ng kurikulum, kabilang ang:

  • Mga bagong nilalaman
  • Mga pagbabago sa istruktura
  • Mga pagpapabuti sa mga tampok
  • Mga update sa dokumentasyon

🛠️ Paano Gamitin nang Epektibo ang Kurikulum na Ito

Bawat aralin sa gabay na ito ay may kasamang:

  1. Malinaw na paliwanag ng mga konsepto ng MCP
  2. Mga live na halimbawa ng code sa iba't ibang wika
  3. Mga pagsasanay para makabuo ng totoong MCP na mga aplikasyon
  4. Karagdagang mga mapagkukunan para sa mga advanced na nag-aaral

🌟 Pasasalamat sa Komunidad

Salamat kay Microsoft Valued Professional Shivam Goyal sa pagbibigay ng mahahalagang halimbawa ng code.

📜 Impormasyon sa Lisensya

Ang nilalamang ito ay lisensyado sa ilalim ng MIT License. Para sa mga tuntunin at kundisyon, tingnan ang LICENSE.

🤝 Mga Patnubay sa Pag-ambag

Malugod na tinatanggap ng proyektong ito ang mga kontribusyon at mungkahi. Karamihan sa mga kontribusyon ay nangangailangan na sumang-ayon ka sa isang Contributor License Agreement (CLA) na nagsasaad na may karapatan ka, at talagang binibigyan mo kami ng mga karapatan na gamitin ang iyong kontribusyon. Para sa mga detalye, bisitahin ang https://cla.opensource.microsoft.com.

Kapag nagsumite ka ng pull request, awtomatikong titignan ng CLA bot kung kailangan mong magbigay ng CLA at lalagyan ng angkop na dekorasyon ang PR (hal., status check, komento). Sundin lamang ang mga tagubiling ibinibigay ng bot. Isang beses mo lang ito kailangang gawin sa lahat ng repos na gumagamit ng aming CLA.

Inampon ng proyektong ito ang Microsoft Open Source Code of Conduct. Para sa karagdagang impormasyon, tingnan ang Code of Conduct FAQ o makipag-ugnayan sa opencode@microsoft.com para sa anumang karagdagang tanong o komento.

📂 Istruktura ng Repositoryo

Ang repositoryo ay inayos tulad ng sumusunod:

  • Core Curriculum (00-10): Pangunahing nilalaman na inayos sa sampung magkakasunod na module
  • images/: Mga diagram at ilustrasyon na ginamit sa buong kurikulum
  • translations/: Suporta sa maraming wika gamit ang automated na pagsasalin
  • translated_images/: Mga lokal na bersyon ng mga diagram at ilustrasyon
  • study_guide.md: Komprehensibong gabay sa pag-navigate ng repositoryo
  • changelog.md: Tala ng lahat ng mahahalagang pagbabago sa mga materyales ng kurikulum
  • mcp.json: Configuration file para sa MCP specification
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Mga dokumento ng pamamahala ng proyekto

🎒 Iba Pang Kurso

Gumagawa rin ang aming koponan ng iba pang mga kurso! Tingnan ang:

™️ Paunawa sa Trademark

Maaaring naglalaman ang proyektong ito ng mga trademark o logo para sa mga proyekto, produkto, o serbisyo. Ang awtorisadong paggamit ng mga trademark o logo ng Microsoft ay napapailalim at dapat sumunod sa Microsoft's Trademark & Brand Guidelines. Ang paggamit ng mga trademark o logo ng Microsoft sa mga binagong bersyon ng proyektong ito ay hindi dapat magdulot ng kalituhan o magpahiwatig ng sponsorship ng Microsoft. Anumang paggamit ng mga trademark o logo ng third-party ay napapailalim sa mga patakaran ng mga iyon.

Paalala:
Ang dokumentong ito ay isinalin gamit ang AI translation service na Co-op Translator. Bagamat nagsusumikap kami para sa katumpakan, pakatandaan na ang mga awtomatikong pagsasalin ay maaaring maglaman ng mga pagkakamali o di-tumpak na impormasyon. Ang orihinal na dokumento sa orihinal nitong wika ang dapat ituring na pangunahing sanggunian. Para sa mahahalagang impormasyon, inirerekomenda ang propesyonal na pagsasalin ng tao. Hindi kami mananagot sa anumang hindi pagkakaunawaan o maling interpretasyon na maaaring magmula sa paggamit ng pagsasaling ito.