Wykonaj poniższe kroki, aby rozpocząć korzystanie z tych zasobów:
- Forkuj repozytorium: Kliknij
- Sklonuj repozytorium:
git clone https://github.com/microsoft/mcp-for-beginners.git - Dołącz do Azure AI Foundry Discord, aby spotkać ekspertów i innych programistów
Arabski | Bengalski | Bułgarski | Birmański (Myanmar) | Chiński (uproszczony) | Chiński (tradycyjny, Hongkong) | Chiński (tradycyjny, Makau) | Chiński (tradycyjny, Tajwan) | Chorwacki | Czeski | Duński | Holenderski | Fiński | Francuski | Niemiecki | Grecki | Hebrajski | Hindi | Węgierski | Indonezyjski | Włoski | Japoński | Koreański | Malajski | Marathi | Nepalski | Norweski | Perski (Farsi) | Polski | Portugalski (Brazylia) | Portugalski (Portugalia) | Pendżabski (Gurmukhi) | Rumuński | Rosyjski | Serbski (cyrylica) | Słowacki | Słoweński | Hiszpański | Suahili | Szwedzki | Tagalog (Filipiński) | Tajski | Turecki | Ukraiński | Urdu | Wietnamski
Model Context Protocol (MCP) to nowoczesne ramy, które mają na celu standaryzację interakcji między modelami AI a aplikacjami klienckimi. Ten otwartoźródłowy program nauczania oferuje uporządkowaną ścieżkę nauki, zawierającą praktyczne przykłady kodu i rzeczywiste przypadki użycia 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 na temat podstaw MCP i strategii wdrażania.
- 📘 Dokumentacja MCP – Szczegółowe samouczki i przewodniki użytkownika
- 📜 Specyfikacja MCP – Architektura protokołu i odniesienia techniczne
- 📜 Oryginalna specyfikacja MCP – Starsze odniesienia techniczne (mogą zawierać dodatkowe szczegóły)
- 🧑💻 Repozytorium MCP na GitHub – Otwartoźródłowe SDK, narzędzia i przykłady kodu
- 🌐 Społeczność MCP – Dołącz do dyskusji i wnieś swój wkład w społeczność
| Moduł | Temat | Opis | Link |
|---|---|---|---|
| Moduły 1-3: Podstawy | |||
| 00 | Wprowadzenie do MCP | Przegląd Model Context Protocol i jego znaczenia w procesach AI | Czytaj więcej |
| 01 | Wyjaśnienie podstawowych pojęć | Szczegółowe omówienie podstawowych 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: Tworzenie pierwszego serwera i klienta | |||
| 3.1 | Pierwszy serwer | Tworzenie pierwszego serwera MCP | Przewodnik |
| 3.2 | Pierwszy klient | Tworzenie podstawowego klienta MCP | Przewodnik |
| 3.3 | Klient z LLM | Integracja dużych modeli językowych | Przewodnik |
| 3.4 | Integracja z VS Code | Konsumpcja serwerów MCP w VS Code | Przewodnik |
| 3.5 | Serwer stdio | Tworzenie serwerów z wykorzystaniem transportu stdio | Przewodnik |
| 3.6 | HTTP Streaming | Implementacja HTTP streamingu w MCP | Przewodnik |
| 3.7 | AI Toolkit | Wykorzystanie AI Toolkit z MCP | Przewodnik |
| 3.8 | Testowanie | Testowanie implementacji serwera MCP | Przewodnik |
| 3.9 | Wdrożenie | Wdrażanie serwerów MCP do produkcji | Przewodnik |
| Moduły 4-5: Praktyczne i zaawansowane | |||
| 04 | Praktyczna implementacja | SDK, debugowanie, testowanie, szablony promptów | Czytaj więcej |
| 05 | Zaawansowane tematy w 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 | Konteksty główne | Zrozumienie i implementacja kontekstów głównych | Przewodnik |
| 5.5 | Routing | Strategie routingu w MCP | Przewodnik |
| 5.6 | Próbkowanie | Techniki prób w MCP | Przewodnik |
| 5.7 | Skalowanie | Skalowanie implementacji MCP | Przewodnik |
| 5.8 | Bezpieczeństwo | Zaawansowane kwestie bezpieczeństwa | Przewodnik |
| 5.9 | Wyszukiwanie w sieci | Implementacja funkcji wyszukiwania w sieci | Przewodnik |
| 5.10 | Streaming w czasie rzeczywistym | Tworzenie funkcji streamingu w czasie rzeczywistym | Przewodnik |
| 5.11 | Wyszukiwanie w czasie rzeczywistym | Implementacja wyszukiwania w czasie rzeczywistym | Przewodnik |
| 5.12 | Uwierzytelnianie Entra ID | Uwierzytelnianie za pomocą Microsoft Entra ID | Przewodnik |
| 5.13 | Integracja z Foundry | Integracja z Azure AI Foundry | Przewodnik |
| 5.14 | Inżynieria kontekstów | Techniki efektywnej inżynierii kontekstów | Przewodnik |
| Moduły 6-10: Społeczność i najlepsze praktyki | |||
| 06 | Wkład społeczności | Jak przyczynić się do rozwoju ekosystemu MCP | Przewodnik |
| 07 | Wnioski z wczesnego wdrożenia | Historie rzeczywistych implementacji | Przewodnik |
| 08 | Najlepsze praktyki dla MCP | Wydajność, odporność na błędy, niezawodność | Przewodnik |
| 09 | Studia przypadków MCP | Praktyczne przykłady implementacji | Przewodnik |
| 10 | Warsztaty praktyczne | Tworzenie serwera MCP z AI Toolkit | Laboratorium |
| Język | Opis | Link |
|---|---|---|
| C# | Przykład serwera MCP | Zobacz kod |
| Java | MCP Kalkulator | Zobacz kod |
| JavaScript | Demo MCP | Zobacz kod |
| Python | Serwer MCP | Zobacz kod |
| TypeScript | Przykład MCP | Zobacz kod |
| Rust | Przykład MCP | Zobacz kod |
| Język | Opis | Link |
|---|---|---|
| C# | Zaawansowany przykład | View Code |
| Java z Spring | Przykład aplikacji kontenerowej | View Code |
| JavaScript | Zaawansowany przykład | View Code |
| Python | Złożona implementacja | View Code |
| TypeScript | Przykład kontenera | View Code |
Aby w pełni skorzystać z tego programu nauczania, powinieneś posiadać:
-
Podstawową wiedzę programistyczną w co najmniej jednym z następujących języków: C#, Java, JavaScript, Python lub TypeScript
-
Zrozumienie modelu klient-serwer i API
-
Znajomość koncepcji REST i HTTP
-
(Opcjonalnie) Podstawy w zakresie AI/ML
-
Dołączenie do naszych dyskusji społecznościowych w celu uzyskania wsparcia
To repozytorium zawiera różne zasoby, które pomogą Ci efektywnie się uczyć:
Dostępny jest kompleksowy Przewodnik nauki, który pomoże Ci efektywnie poruszać się po tym repozytorium. Przewodnik zawiera:
- Wizualną mapę programu nauczania obejmującą wszystkie omawiane tematy
- Szczegółowy podział każdej sekcji repozytorium
- Wskazówki dotyczące korzystania z projektów przykładowych
- Rekomendowane ścieżki nauki dla różnych poziomów zaawansowania
- Dodatkowe zasoby uzupełniające Twoją podróż edukacyjną
Prowadzimy szczegółowy Dziennik zmian, który śledzi wszystkie istotne aktualizacje materiałów programu nauczania, w tym:
- Dodanie nowej treś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 uczniów
Przygotuj się na dwa dni głębokich technicznych wglądów, nawiązywania kontaktów społecznościowych i praktycznej nauki podczas MCP Dev Days, wirtualnego wydarzenia poświęconego Model Context Protocol (MCP) — nowemu standardowi łączącemu modele AI i narzędzia, na których się opierają. Możesz obejrzeć MCP Dev Days, rejestrując się na naszej stronie wydarzenia: https://aka.ms/mcpdevdays.
Skupia się na umożliwieniu programistom korzystania z MCP w ich codziennym przepływie pracy oraz na ś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, aby kształtować otwarty, rozszerzalny ekosystem MCP.
Dema rzeczywiste w VS Code, Visual Studio, GitHub Copilot i popularnych narzędziach społecznościowych
Praktyczne, kontekstowe przepływy pracy dla programistów
Sesje prowadzone przez społeczność i wglądy
Niezależnie od tego, czy dopiero zaczynasz przygodę z MCP, czy już z nim budujesz, Dzień 1 dostarczy inspiracji i praktycznych wskazówek.
Skierowany do twórców MCP. Zgłębimy strategie implementacji i najlepsze praktyki dotyczące tworzenia serwerów MCP oraz integracji MCP w przepływach pracy AI.
- Tworzenie serwerów MCP i ich integracja z doświadczeniami agentów
- Rozwój oparty na promptach
- Najlepsze praktyki w zakresie bezpieczeństwa
- Korzystanie z bloków konstrukcyjnych, 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 wglądów, których potrzebujesz, aby budować skalowalne, bezpieczne i przyszłościowe rozwiązania MCP.
Naucz się w intensywnych sesjach wideo, jak tworzyć serwery MCP, integrować je z VS Code i profesjonalnie wdrażać na Azure na podstawie treści z programu MCP dla początkujących. Zdobądź praktyczne umiejętności w technologii, którą już wykorzystują największe firmy.
Dziękujemy Microsoft Valued Professional Shivam Goyal za wkład w ważne przykłady kodu.
Treść ta jest licencjonowana na podstawie MIT License. Warunki i zasady znajdziesz w LICENSE.
Ten projekt przyjmuje wkłady i sugestie. Większość wkładów wymaga od Ciebie zgody na Contributor License Agreement (CLA), deklarując, że masz prawo i faktycznie udzielasz nam praw do korzystania z Twojego wkładu. Szczegóły znajdziesz na https://cla.opensource.microsoft.com.
Gdy przesyłasz pull request, bot CLA automatycznie określi, czy musisz dostarczyć CLA i odpowiednio oznaczy PR (np. status check, komentarz). Po prostu postępuj zgodnie z instrukcjami podanymi przez bota. Musisz to zrobić tylko raz dla wszystkich repozytoriów korzystających z naszego CLA.
Ten projekt przyjął Microsoft Open Source Code of Conduct. Więcej informacji znajdziesz w Code of Conduct FAQ lub skontaktuj się z opencode@microsoft.com w przypadku dodatkowych pytań lub komentarzy.
Repozytorium jest zorganizowane w następujący sposób:
- Core Curriculum (00-10): Główna treść zorganizowana w dziesięć kolejnych modułów
- images/: Diagramy i ilustracje używane w całym programie nauczania
- translations/: Obsługa wielu języków z automatycznymi tłumaczeniami
- translated_images/: Lokalizowane 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 dla specyfikacji MCP
- CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Dokumenty dotyczące zarządzania projektem
Nasz zespół tworzy inne kursy! Sprawdź:
- AI Agents For Beginners
- Generative AI for Beginners using .NET
- Generative AI for Beginners using JavaScript
- Generative AI for Beginners
- Generative AI for Beginners using Java
- 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 Microsoftu podlega i musi być zgodne z Microsoft's Trademark & Brand Guidelines. Użycie znaków towarowych lub logotypów Microsoftu w zmodyfikowanych wersjach tego projektu nie może powodować zamieszania ani sugerować sponsorowania przez Microsoft. Każde użycie znaków towarowych lub logotypów stron trzecich podlega politykom tych stron trzecich.
Zastrzeżenie:
Ten dokument został przetłumaczony za pomocą usługi tłumaczeniowej AI Co-op Translator. Chociaż dokładamy wszelkich starań, aby tłumaczenie było precyzyjne, prosimy pamiętać, że automatyczne tłumaczenia mogą zawierać błędy lub nieścisłości. Oryginalny dokument w jego rodzimym języku powinien być uznawany za wiarygodne źródło. W przypadku informacji krytycznych zaleca się 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.