Wykonaj te kroki, aby rozpocząć korzystanie z tych zasobów:
- Zrób fork repozytorium: Kliknij
- Sklonuj repozytorium:
git clone https://github.com/microsoft/mcp-for-beginners.git - Dołącz do Azure AI Foundry Discord i poznaj ekspertów oraz innych programistów
Francuski | Hiszpański | Niemiecki | Rosyjski | Arabski | Perski (Farsi) | Urdu | Chiński (uproszczony) | Chiński (tradycyjny, Makau) | Chiński (tradycyjny, Hongkong) | Chiński (tradycyjny, Tajwan) | Japoński | Koreański | Hindi | Bengalski | Marathi | Nepalski | Pendżabski (Gurmukhi) | Portugalski (Portugalia) | Portugalski (Brazylia) | Włoski | Polski | Turecki | Grecki | Tajski | Szwedzki | Duński | Norweski | Fiński | Holenderski | Hebrajski | Wietnamski | Indonezyjski | Malajski | Tagalog (Filipiński) | Suahili | Węgierski | Czeski | Słowacki | Rumuński | Bułgarski | Serbski (cyrylica) | Chorwacki | Słoweński | Ukraiński | Birmański (Myanmar)
Model Context Protocol (MCP) to nowoczesny framework zaprojektowany, aby ustandaryzować interakcje między modelami AI a aplikacjami klienckimi. Ten otwarty program nauczania oferuje uporządkowaną ścieżkę nauki, zawierającą praktyczne przykłady kodu i rzeczywiste zastosowania, w popularnych językach programowania takich jak C#, Java, JavaScript, TypeScript i Python.
Niezależnie od tego, czy jesteś programistą AI, architektem systemów czy inżynierem oprogramowania, ten przewodnik jest Twoim kompleksowym źródłem wiedzy o podstawach MCP i strategiach implementacji.
- 📘 Dokumentacja MCP – Szczegółowe samouczki i przewodniki użytkownika
- 📜 Specyfikacja MCP – Architektura protokołu i odniesienia techniczne
- 📜 Oryginalna specyfikacja MCP – Dziedzictwo odniesień technicznych (może zawierać dodatkowe szczegóły)
- 🧑💻 Repozytorium MCP na GitHub – Otwarte SDK, narzędzia i przykłady kodu
- 🌐 Społeczność MCP – Dołącz do dyskusji i współtwórz społeczność
Przygotuj się na dwa dni głębokich technicznych wglądów, nawiązywania kontaktów i praktycznej nauki podczas MCP Dev Days, wirtualnego wydarzenia poświęconego Model Context Protocol (MCP) — nowemu standardowi łączącemu modele AI z narzędziami, na których polegają.
➡️ Zarejestruj się na MCP Dev Days
Możesz oglądać MCP Dev Days, rejestrując się na naszej stronie wydarzenia: https://aka.ms/mcpdevdays. Stamtąd będziesz mógł dołączyć do transmisji na żywo na YouTube lub Twitch. Cała zawartość jest nagrywana i będzie dostępna później na kanale Microsoft Developer na YouTube. Kod źródłowy do demonstracji będzie również dostępny na GitHub.
- Daty: 29 lipca (Dzień 1) i 30 lipca (Dzień 2)
- Godzina: codziennie od 9:00 PST
- Miejsce: Online – dołącz z dowolnego miejsca!
Skupia się na umożliwieniu programistom korzystania z MCP w ich codziennej pracy oraz świętowaniu niesamowitej społeczności MCP. Dołączą do nas członkowie społeczności i partnerzy tacy jak Arcade, Block, Okta i Neon, aby pokazać, jak współpracują z Microsoftem, tworząc otwarty, rozszerzalny ekosystem MCP. Pokazy na żywo w VS Code, Visual Studio, GitHub Copilot i popularnych narzędziach społecznościowych
Praktyczne, kontekstowe workflow deweloperskie
Sesje prowadzone przez społeczność i cenne spostrzeżenia
Niezależnie od tego, czy dopiero zaczynasz z MCP, czy już z nim pracujesz, Dzień 1 dostarczy inspiracji i praktycznych wskazówek.
Przeznaczony dla twórców MCP. Zagłębimy się w strategie implementacji i najlepsze praktyki tworzenia serwerów MCP oraz integracji MCP w Twoich przepływach AI.
- Budowa serwerów MCP i integracja ich z doświadczeniami agentów
- Rozwój oparty na promptach
- Najlepsze praktyki bezpieczeństwa
- Wykorzystanie elementów takich jak Functions, ACA i API Management
- Wyrównanie rejestru i narzędzia (1P + 3P)
Jeśli jesteś programistą, twórcą narzędzi lub strategiem produktów AI, ten dzień jest pełen wiedzy potrzebnej do budowy skalowalnych, bezpiecznych i gotowych na przyszłość rozwiązań MCP.
| Moduł | Temat | Opis | Link |
|---|---|---|---|
| Moduły 1-3: Podstawy | |||
| 00 | Wprowadzenie do MCP | Przegląd Model Context Protocol i jego znaczenia w pipeline’ach AI | Czytaj więcej |
| 01 | Wyjaśnienie podstawowych pojęć | Dogłębne omówienie kluczowych koncepcji MCP | Czytaj więcej |
| 02 | Bezpieczeństwo w MCP | Zagrożenia bezpieczeństwa i najlepsze praktyki | Czytaj więcej |
| 03 | Pierwsze kroki z MCP | Konfiguracja środowiska, podstawowe serwery/klienci, integracja | Czytaj więcej |
| Moduł 3: Budowa pierwszego serwera i klienta | |||
| 3.1 | Pierwszy serwer | Stwórz swój pierwszy serwer MCP | Przewodnik |
| 3.2 | Pierwszy klient | Opracuj podstawowego klienta MCP | Przewodnik |
| 3.3 | Klient z LLM | Integracja dużych modeli językowych | Przewodnik |
| 3.4 | Integracja z VS Code | Konsumuj serwery MCP w VS Code | Przewodnik |
| 3.5 | Serwer SSE | Twórz serwery wykorzystujące Server-Sent Events | Przewodnik |
| 3.6 | Strumieniowanie HTTP | Implementuj strumieniowanie HTTP w MCP | Przewodnik |
| 3.7 | AI Toolkit | Korzystaj z AI Toolkit z MCP | Przewodnik |
| 3.8 | Testowanie | Testuj swoją implementację serwera MCP | Przewodnik |
| 3.9 | Wdrożenie | Wdróż serwery MCP do produkcji | Przewodnik |
| Moduły 4-5: Praktyczne i zaawansowane | |||
| 04 | Praktyczna implementacja | SDK, debugowanie, testowanie, wielokrotnego użytku szablony promptów | Czytaj więcej |
| 05 | Zaawansowane tematy MCP | AI multimodalne, skalowanie, zastosowania korporacyjne | Czytaj więcej |
| 5.1 | Integracja z Azure | Integracja MCP z Azure | Przewodnik |
| 5.2 | Multimodalność | Praca z wieloma modalnościami | Przewodnik |
| 5.3 | Demo OAuth2 | Implementacja uwierzytelniania OAuth2 | Przewodnik |
| 5.4 | Root Contexts | Zrozumienie i implementacja root contexts | Przewodnik |
| 5.5 | Routing | Strategie routingu MCP | Przewodnik |
| 5.6 | Sampling | Techniki próbkowania w MCP | Przewodnik |
| 5.7 | Skalowanie | Skalowanie implementacji MCP | Przewodnik |
| 5.8 | Bezpieczeństwo | Zaawansowane aspekty bezpieczeństwa | Przewodnik |
| 5.9 | Wyszukiwanie w sieci | Implementacja funkcji wyszukiwania w sieci | Przewodnik |
| 5.10 | Strumieniowanie w czasie rzeczywistym | Budowa funkcjonalności strumieniowania na żywo | Przewodnik |
| 5.11 | Wyszukiwanie w czasie rzeczywistym | Implementacja wyszukiwania w czasie rzeczywistym | Przewodnik |
| 5.12 | Entra ID Auth | Uwierzytelnianie za pomocą Microsoft Entra ID | Przewodnik |
| 5.13 | Integracja z Foundry | Integracja z Azure AI Foundry | Przewodnik |
| 5.14 | Inżynieria kontekstu | Techniki efektywnej inżynierii kontekstu | Przewodnik |
| Moduły 6-10: Społeczność i najlepsze praktyki | |||
| 06 | Wkład społeczności | Jak wnosić wkład do ekosystemu MCP | Przewodnik |
| 07 | Wnioski z wczesnej adopcji | Historie wdrożeń z rzeczywistego świata | Przewodnik |
| 08 | Najlepsze praktyki MCP | Wydajność, odporność na błędy, niezawodność | Przewodnik |
| 09 | Studia przypadków MCP | Praktyczne przykłady wdrożeń | Przewodnik |
| 10 | Warsztaty praktyczne | Budowa serwera MCP z AI Toolkit | Laboratorium |
| Język | Opis | Link |
|---|---|---|
| C# | Przykład serwera MCP | Zobacz kod |
| Java | Kalkulator MCP | Zobacz kod |
| JavaScript | Demo MCP | Zobacz kod |
| Python | Serwer MCP | Zobacz kod |
| TypeScript | Przykład MCP | Zobacz kod |
| Język | Opis | Link |
|---|---|---|
| C# | Zaawansowany przykład | Zobacz kod |
| Java | Przykład aplikacji kontenerowej | Zobacz kod |
| JavaScript | Zaawansowany przykład | Zobacz kod |
| Python | Złożona implementacja | Zobacz kod |
| TypeScript | Przykład kontenera | Zobacz kod |
Aby w pełni wykorzystać ten program nauczania, powinieneś mieć:
-
Podstawową znajomość programowania w co najmniej jednym z następujących języków: C#, Java, JavaScript, Python lub TypeScript
-
Zrozumienie modelu klient-serwer oraz API
-
Znajomość koncepcji REST i HTTP
-
(Opcjonalnie) Podstawy AI/ML
-
Udział w dyskusjach naszej społeczności w celu uzyskania wsparcia
To repozytorium zawiera kilka zasobów, które pomogą Ci efektywnie się uczyć i poruszać po materiałach:
Dostępny jest obszerny Przewodnik nauki, który pomoże Ci skutecznie poruszać się po repozytorium. Przewodnik zawiera:
- Wizualną mapę programu nauczania pokazującą wszystkie omawiane tematy
- Szczegółowy podział każdej sekcji repozytorium
- Wskazówki, jak korzystać z przykładowych projektów
- Rekomendowane ścieżki nauki dla różnych poziomów zaawansowania
- Dodatkowe zasoby wspierające proces nauki
Prowadzimy szczegółowy Dziennik zmian, który śledzi wszystkie istotne aktualizacje materiałów programu nauczania, w tym:
- Dodanie nowej zawartości
- Zmiany strukturalne
- Ulepszenia funkcji
- Aktualizacje dokumentacji
Każda lekcja w tym przewodniku zawiera:
- Jasne wyjaśnienia koncepcji MCP
- Przykłady kodu na żywo w różnych językach
- Ćwiczenia do tworzenia rzeczywistych aplikacji MCP
- Dodatkowe zasoby dla zaawansowanych użytkowników
Podziękowania dla Microsoft Valued Professional Shivam Goyal za wkład w ważne przykłady kodu.
Ta zawartość jest objęta licencją MIT License. Warunki licencji znajdziesz w pliku LICENSE.
Ten projekt zachęca do współpracy i sugestii. Większość wkładów wymaga zgody na Contributor License Agreement (CLA), w którym oświadczasz, że masz prawo i faktycznie udzielasz nam praw do korzystania z Twojego wkładu. Szczegóły znajdziesz na stronie https://cla.opensource.microsoft.com.
Po przesłaniu pull requesta, bot CLA automatycznie sprawdzi, czy musisz dostarczyć CLA i odpowiednio oznaczy PR (np. status, komentarz). Wystarczy, że wykonasz te kroki raz dla wszystkich repozytoriów korzystających z naszego CLA.
Projekt przyjął Microsoft Open Source Code of Conduct. Więcej informacji znajdziesz w Code of Conduct FAQ lub kontaktując się pod adresem opencode@microsoft.com w razie dodatkowych pytań lub uwag.
Repozytorium jest zorganizowane następująco:
- Core Curriculum (00-10): Główne materiały podzielone na dziesięć kolejnych modułów
- images/: Diagramy i ilustracje używane w całym programie nauczania
- translations/: Wsparcie wielojęzyczne z automatycznymi tłumaczeniami
- translated_images/: Zlokalizowane wersje diagramów i ilustracji
- study_guide.md: Kompleksowy przewodnik po repozytorium
- changelog.md: Rejestr wszystkich istotnych zmian w materiałach programu nauczania
- mcp.json: Plik konfiguracyjny specyfikacji MCP
- CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Dokumenty zarządzające projektem
Nasz zespół tworzy także inne kursy! Sprawdź:
- AI Agents For Beginners
- Generative AI for Beginners using .NET
- Generative AI for Beginners using JavaScript
- Generative AI for Beginners
- ML for Beginners
- Data Science for Beginners
- AI for Beginners
- Cybersecurity for Beginners
- Web Dev for Beginners
- IoT for Beginners
- XR Development for Beginners
- Mastering GitHub Copilot for AI Paired Programming
- Mastering GitHub Copilot for C#/.NET Developers
- Choose Your Own Copilot Adventure
Ten projekt może zawierać znaki towarowe lub logotypy projektów, produktów lub usług. Autoryzowane użycie znaków towarowych lub logotypów Microsoft podlega i musi być zgodne z Microsoft's Trademark & Brand Guidelines. Użycie znaków towarowych lub logotypów Microsoft w zmodyfikowanych wersjach tego projektu nie może wprowadzać w błąd ani sugerować sponsorowania przez Microsoft. Wszelkie użycie znaków towarowych lub logotypów stron trzecich podlega politykom tych stron.
Zastrzeżenie:
Niniejszy dokument został przetłumaczony za pomocą usługi tłumaczenia AI Co-op Translator. Mimo że dokładamy starań, aby tłumaczenie było jak najbardziej precyzyjne, prosimy mieć na uwadze, że automatyczne tłumaczenia mogą zawierać błędy lub nieścisłości. Oryginalny dokument w języku źródłowym należy traktować jako źródło autorytatywne. W przypadku informacji o kluczowym znaczeniu zalecane jest skorzystanie z profesjonalnego tłumaczenia wykonanego przez człowieka. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z korzystania z tego tłumaczenia.