Skip to content

Latest commit

 

History

History
265 lines (198 loc) · 21.2 KB

File metadata and controls

265 lines (198 loc) · 21.2 KB

MCP-para-sa-mga-baguhan

Mga Kontribyutor sa GitHub Mga Isyu sa GitHub Mga Pull Request sa GitHub PRs Welcome

Mga Tagasubaybay sa GitHub Mga Fork sa GitHub Mga Bituin sa GitHub

Microsoft Azure AI Foundry Discord

Sundin ang mga hakbang na ito upang magsimula sa paggamit ng mga resources na ito:

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

🌐 Suporta sa Multi-Language

Sinusuportahan sa pamamagitan ng GitHub Action (Automated at Laging Napapanahon)

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

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

🧠 Pangkalahatang-ideya ng Kurikulum ng Model Context Protocol

Ang Model Context Protocol (MCP) ay isang makabagong framework na idinisenyo upang gawing standard ang interaksyon sa pagitan ng mga AI model at client application. Ang open-source na kurikulum na ito ay nag-aalok ng isang organisadong landas sa pag-aaral, na may kasamang mga praktikal na halimbawa ng code at mga tunay na kaso ng paggamit, sa mga sikat na programming language tulad ng C#, Java, JavaScript, TypeScript, at Python.

Kung ikaw ay isang AI developer, system architect, o software engineer, ang gabay na ito ang iyong komprehensibong resource para ma-master ang mga pangunahing kaalaman at estratehiya sa implementasyon ng MCP.

🔗 Opisyal na Mga Resource ng MCP

🧭 Pangkalahatang-ideya ng Kurikulum ng MCP

📚 Kumpletong Estruktura ng Kurikulum

Module Paksa Deskripsyon Link
Module 1-3: Mga Pangunahing Kaalaman
00 Panimula sa MCP Pangkalahatang-ideya ng Model Context Protocol at kahalagahan nito sa AI pipelines Basahin pa
01 Paliwanag sa Mga Pangunahing Konsepto Masusing 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 Setup ng environment, mga pangunahing server/client, integrasyon Basahin pa
Module 3: Pagbuo ng Iyong Unang Server at Client
3.1 Unang Server Gumawa ng iyong unang MCP server Gabay
3.2 Unang Client Bumuo ng isang pangunahing MCP client Gabay
3.3 Client na may LLM Isama ang mga large language model Gabay
3.4 Integrasyon ng VS Code Gamitin ang MCP server sa VS Code Gabay
3.5 stdio Server Gumawa ng mga server gamit ang stdio transport Gabay
3.6 HTTP Streaming Mag-implement ng HTTP streaming sa MCP Gabay
3.7 AI Toolkit Gamitin ang AI Toolkit sa MCP Gabay
3.8 Pagsusuri Subukan ang implementasyon ng iyong MCP server Gabay
3.9 Deployment I-deploy ang MCP server sa production Gabay
Module 4-5: Praktikal at Advanced
04 Praktikal na Implementasyon Mga SDK, debugging, pagsusuri, reusable na prompt template Basahin pa
05 Mga Advanced na Paksa sa MCP Multi-modal AI, scaling, enterprise use Basahin pa
5.1 Integrasyon sa Azure Integrasyon ng MCP sa Azure Gabay
5.2 Multi-modality Paggamit ng maraming modality Gabay
5.3 OAuth2 Demo Mag-implement ng OAuth2 authentication Gabay
5.4 Root Contexts Unawain at i-implement ang root contexts Gabay
5.5 Routing Mga estratehiya sa routing ng MCP Gabay
5.6 Sampling Mga teknik sa sampling sa MCP Gabay
5.7 Scaling Palawakin ang implementasyon ng MCP Gabay
5.8 Seguridad Mga advanced na konsiderasyon sa seguridad Gabay
5.9 Web Search Mag-implement ng kakayahan sa web search Gabay
5.10 Realtime Streaming Bumuo ng realtime streaming functionality Gabay
5.11 Realtime Search Mag-implement ng realtime search Gabay
5.12 Entra ID Auth Authentication gamit ang Microsoft Entra ID Gabay
5.13 Integrasyon sa Foundry Integrasyon sa Azure AI Foundry Gabay
5.14 Context Engineering Mga teknik para sa epektibong context engineering Gabay
Module 6-10: Komunidad at Mga Pinakamahusay na Kasanayan
06 Mga Ambag ng Komunidad Paano mag-ambag sa ecosystem ng MCP Gabay
07 Mga Aral mula sa Maagang Paggamit Mga kwento ng tunay na implementasyon Gabay
08 Mga Pinakamahusay na Kasanayan para sa MCP Performance, fault-tolerance, resilience Gabay
09 Mga Kaso ng Pag-aaral ng MCP Mga praktikal na halimbawa ng implementasyon Gabay
10 Hands-on Workshop Pagbuo ng MCP Server gamit ang AI Toolkit Lab

💻 Mga Proyekto ng Halimbawa ng Code

Mga Pangunahing Halimbawa ng MCP Calculator

Wika Deskripsyon Link
C# Halimbawa ng MCP Server Tingnan ang Code
Java MCP Calculator Tingnan ang Code
JavaScript MCP Demo Tingnan ang Code
Python MCP Server Tingnan ang Code
TypeScript Halimbawa ng MCP Tingnan ang Code
Rust Halimbawa ng MCP Tingnan ang Code

Mga Advanced na Implementasyon ng MCP

Wika Deskripsyon Link
C# Advanced Sample View Code
Java with Spring Halimbawa ng Container App View Code
JavaScript Advanced Sample View Code
Python Komplikadong Implementasyon View Code
TypeScript Halimbawa ng Container View Code

🎯 Mga Kinakailangan para sa Pag-aaral ng MCP

Para masulit ang kurikulum na ito, dapat kang magkaroon ng:

  • 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) Background sa mga konsepto ng AI/ML

  • Sumali sa aming mga talakayan sa komunidad para sa suporta

📚 Gabay sa Pag-aaral at Mga Mapagkukunan

Ang repository na ito ay naglalaman ng iba't ibang mapagkukunan upang matulungan kang mag-navigate at matuto nang epektibo:

Gabay sa Pag-aaral

Isang komprehensibong Gabay sa Pag-aaral ang magagamit upang matulungan kang mag-navigate sa repository na ito nang epektibo. Ang gabay ay naglalaman ng:

  • Isang visual na mapa ng kurikulum na nagpapakita ng lahat ng mga paksang saklaw
  • Detalyadong pagkakahati ng bawat seksyon ng repository
  • Gabay kung paano gamitin ang mga sample na proyekto
  • Mga inirerekomendang landas sa pag-aaral para sa iba't ibang antas ng kasanayan
  • Karagdagang mapagkukunan upang madagdagan ang iyong paglalakbay sa pag-aaral

Changelog

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

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

🛠️ Paano Gamitin ang Kurikulum na Ito nang Epektibo

Ang bawat aralin sa gabay na ito ay naglalaman ng:

  1. Malinaw na paliwanag ng mga konsepto ng MCP
  2. Mga live na halimbawa ng code sa iba't ibang wika
  3. Mga ehersisyo para bumuo ng mga tunay na MCP application
  4. Karagdagang mapagkukunan para sa mga advanced na mag-aaral

Mga Kaganapan

Maghanda para sa dalawang araw ng malalim na teknikal na kaalaman, koneksyon sa komunidad, at hands-on na pag-aaral sa MCP Dev Days, isang virtual na kaganapan na nakatuon sa Model Context Protocol (MCP) — ang umuusbong na pamantayan na nag-uugnay sa mga AI model at ang mga tool na kanilang ginagamit. Maaari mong panoorin ang MCP Dev Days sa pamamagitan ng pagrehistro sa aming pahina ng kaganapan: https://aka.ms/mcpdevdays.

Nakatuon sa pagbibigay kapangyarihan sa mga developer na gamitin ang MCP sa kanilang workflow bilang developer at sa pagdiriwang ng kamangha-manghang komunidad ng MCP. Makakasama ang mga miyembro ng komunidad at mga kasosyo tulad ng Arcade, Block, Okta, at Neon upang makita kung paano sila nakikipagtulungan sa Microsoft upang hubugin ang isang bukas, extensible na ekosistema ng MCP. Mga demo sa totoong mundo sa VS Code, Visual Studio, GitHub Copilot, at mga sikat na tool ng komunidad Praktikal, context-driven na workflow bilang developer Mga sesyon na pinangungunahan ng komunidad at mga insight Kung nagsisimula ka pa lang sa MCP o gumagawa na gamit ito, ang Araw 1 ay magbibigay ng inspirasyon at mga actionable na takeaway.

Para sa mga tagabuo ng MCP. Magpapalalim kami sa mga estratehiya sa implementasyon at pinakamahusay na kasanayan para sa paglikha ng MCP servers at pagsasama ng MCP sa iyong mga workflow ng AI.

Mga Paksa:

  • Pagbuo ng MCP Servers at pagsasama ng mga ito sa mga karanasan ng agent
  • Prompt-driven na pag-unlad
  • 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 isang developer, tagabuo ng tool, o strategist ng produkto ng AI, ang araw na ito ay puno ng mga insight na kailangan mo upang bumuo ng scalable, secure, at future-ready na mga solusyon sa MCP.

MCP Boot Camp Agosto 2025

Matuto sa mga intensive na video session kung paano gumawa ng MCP servers, isama sa VS Code, at mag-deploy nang propesyonal sa Azure batay sa nilalaman mula sa MCP para sa Beginners na kurikulum. Umalis na may praktikal na kasanayan sa isang teknolohiya na ginagamit na ng mga pangunahing kumpanya.

🌟 Pasasalamat sa Komunidad

Salamat sa Microsoft Valued Professional Shivam Goyal para sa pag-aambag 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 Alituntunin sa Pag-aambag

Ang proyektong ito ay tumatanggap ng mga kontribusyon at mungkahi. Karamihan sa mga kontribusyon ay nangangailangan sa iyo na sumang-ayon sa isang Contributor License Agreement (CLA) na nagsasaad na mayroon kang karapatan, at aktwal na ginagawa, na bigyan 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 matutukoy ng CLA bot kung kailangan mong magbigay ng CLA at palamutihan ang PR nang naaangkop (hal., status check, komento). Sundin lamang ang mga tagubilin na ibinigay ng bot. Kailangan mo lamang gawin ito nang isang beses sa lahat ng mga repo na gumagamit ng aming CLA.

Ang proyektong ito ay nagpatibay ng 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 Repository

Ang repository ay nakaayos tulad ng sumusunod:

  • Core Curriculum (00-10): Ang pangunahing nilalaman na nakaayos sa sampung sunud-sunod na mga module
  • images/: Mga diagram at ilustrasyon na ginagamit sa buong kurikulum
  • translations/: Suporta sa multi-language na may automated na mga pagsasalin
  • translated_images/: Lokal na bersyon ng mga diagram at ilustrasyon
  • study_guide.md: Komprehensibong gabay sa pag-navigate sa repository
  • changelog.md: Talaan 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

Ang aming koponan ay gumagawa ng iba pang mga kurso! Tingnan ang:

™️ Paalala sa Trademark

Ang proyektong ito ay maaaring naglalaman ng mga trademark o logo para sa mga proyekto, produkto, o serbisyo. Ang awtorisadong paggamit ng mga trademark o logo ng Microsoft ay napapailalim sa 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. Ang anumang paggamit ng mga trademark o logo ng third-party ay napapailalim sa mga patakaran ng mga third-party na iyon.


Paunawa:
Ang dokumentong ito ay isinalin gamit ang AI translation service na Co-op Translator. Bagama't sinisikap naming maging tumpak, tandaan na ang mga awtomatikong pagsasalin ay maaaring maglaman ng mga pagkakamali o hindi pagkakatugma. Ang orihinal na dokumento sa kanyang katutubong wika ang dapat ituring na opisyal na sanggunian. Para sa mahalagang impormasyon, inirerekomenda ang propesyonal na pagsasalin ng tao. Hindi kami mananagot sa anumang hindi pagkakaunawaan o maling interpretasyon na dulot ng paggamit ng pagsasaling ito.