MCP dla początkujących

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Postępuj zgodnie z poniższymi krokami, aby rozpocząć korzystanie z tych zasobów:

  1. Sforkuj repozytorium: Kliknij GitHub forks
  2. Sklonuj repozytorium: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Dołącz do Discorda Azure AI Foundry i poznaj ekspertów oraz innych programistów

🌐 Obsługa wielu języków

Obsługiwane przez GitHub Action (Automatyczne i zawsze aktualne)

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) | Punjabi (Gurmukhi) | Rumuński | Rosyjski | Serbski (cyrylica) | Słowacki | Słoweński | Hiszpański | Suahili | Szwedzki | Tagalog (Filipiński) | Tajski | Turecki | Ukraiński | Urdu | Wietnamski

🚀 Program nauczania Model Context Protocol (MCP) dla początkujących

Poznaj MCP dzięki praktycznym przykładom kodu w C#, Java, JavaScript, Rust, Python i TypeScript

🧠 Przegląd programu nauczania Model Context Protocol

Model Context Protocol (MCP) to nowoczesne ramy, które mają na celu standaryzację interakcji 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 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 kompleksowym źródłem wiedzy na temat podstaw MCP i strategii wdrożeniowych.

🔗 Oficjalne zasoby MCP

🧭 Przegląd programu nauczania MCP

📚 Kompletny program nauczania

ModułTematOpisLink
Moduł 1-3: Podstawy
00Wprowadzenie do MCPPrzegląd Model Context Protocol i jego znaczenia w procesach AICzytaj więcej
01Wyjaśnienie podstawowych pojęćSzczegółowe omówienie podstawowych koncepcji MCPCzytaj więcej
02Bezpieczeństwo w MCPZagrożenia bezpieczeństwa i najlepsze praktykiCzytaj więcej
03Pierwsze kroki z MCPKonfiguracja środowiska, podstawowe serwery/klienci, integracjaCzytaj więcej
Moduł 3: Tworzenie pierwszego serwera i klienta
3.1Pierwszy serwerUtwórz swój pierwszy serwer MCPPrzewodnik
3.2Pierwszy klientOpracuj podstawowego klienta MCPPrzewodnik
3.3Klient z LLMZintegruj duże modele językowePrzewodnik
3.4Integracja z VS CodeKonsumuj serwery MCP w VS CodePrzewodnik
3.5Serwer stdioTwórz serwery korzystające z transportu stdioPrzewodnik
3.6Streaming HTTPWdrażanie streamingu HTTP w MCPPrzewodnik
3.7Narzędzia AIKorzystanie z narzędzi AI w MCPPrzewodnik
3.8TestowanieTestowanie implementacji serwera MCPPrzewodnik
3.9WdrożenieWdrażanie serwerów MCP w produkcjiPrzewodnik
3.10Zaawansowane użycie serweraKorzystanie z zaawansowanych serwerów dla zaawansowanych funkcji i ulepszonej architekturyPrzewodnik
3.11Prosta autoryzacjaRozdział pokazujący autoryzację od podstaw i RBACPrzewodnik
Moduł 4-5: Praktyczne i zaawansowane
04Praktyczna implementacjaSDK, debugowanie, testowanie, wielokrotnego użytku szablony promptówCzytaj więcej
05Zaawansowane tematy w MCPAI multimodalne, skalowanie, zastosowania korporacyjneCzytaj więcej
5.1Integracja z AzureIntegracja MCP z AzurePrzewodnik
5.2MultimodalnośćPraca z wieloma modalnościamiPrzewodnik
5.3Demo OAuth2Wdrażanie uwierzytelniania OAuth2Przewodnik
5.4Konteksty główneZrozumienie i wdrożenie kontekstów głównychPrzewodnik
5.5RoutingStrategie routingu MCPPrzewodnik
5.6PróbkowanieTechniki próbkowania w MCPPrzewodnik
5.7SkalowanieSkalowanie implementacji MCPPrzewodnik
5.8BezpieczeństwoZaawansowane rozważania dotyczące bezpieczeństwaPrzewodnik
5.9Wyszukiwanie w sieciWdrażanie funkcji wyszukiwania w sieciPrzewodnik
5.10Streaming w czasie rzeczywistymTworzenie funkcji streamingu w czasie rzeczywistymPrzewodnik
5.11Wyszukiwanie w czasie rzeczywistymWdrażanie wyszukiwania w czasie rzeczywistymPrzewodnik
5.12Autoryzacja Entra IDUwierzytelnianie za pomocą Microsoft Entra IDPrzewodnik
5.13Integracja z FoundryIntegracja z Azure AI FoundryPrzewodnik
5.14Inżynieria kontekstówTechniki efektywnej inżynierii kontekstówPrzewodnik
5.15Niestandardowy transport MCPImplementacje niestandardowego transportuPrzewodnik
Moduł 6-10: Społeczność i najlepsze praktyki
06Wkład społecznościJak wnosić wkład w ekosystem MCPPrzewodnik
07Wnioski z wczesnego wdrożeniaHistorie rzeczywistych implementacjiPrzewodnik
08Najlepsze praktyki dla MCPWydajność, odporność na błędy, odpornośćPrzewodnik
09Studia przypadków MCPPrzykłady praktycznych implementacjiPrzewodnik
10Warsztaty praktyczneTworzenie serwera MCP z narzędziami AILaboratorium
Moduł 11: Laboratorium praktyczne serwera MCP
11Integracja serwera MCP z bazą danychKompleksowa ścieżka nauki w 13 laboratoriach dla integracji z PostgreSQLLaboratoria
11.1WprowadzeniePrzegląd MCP z integracją bazy danych i przypadkiem użycia analityki detalicznejLaboratorium 00
11.2Architektura rdzeniaZrozumienie architektury serwera MCP, warstw bazy danych i wzorców bezpieczeństwaLab 01
11.3Bezpieczeństwo i wielodostępnośćBezpieczeństwo na poziomie wiersza, uwierzytelnianie i dostęp do danych dla wielu najemcówLab 02
11.4Konfiguracja środowiskaKonfiguracja środowiska deweloperskiego, Docker, zasoby AzureLab 03
11.5Projektowanie bazy danychKonfiguracja PostgreSQL, projektowanie schematu dla handlu detalicznego i dane przykładoweLab 04
11.6Implementacja serwera MCPTworzenie serwera FastMCP z integracją bazy danychLab 05
11.7Tworzenie narzędziTworzenie narzędzi do zapytań do bazy danych i introspekcji schematuLab 06
11.8Wyszukiwanie semantyczneImplementacja osadzania wektorów z Azure OpenAI i pgvectorLab 07
11.9Testowanie i debugowanieStrategie testowania, narzędzia debugowania i podejścia do walidacjiLab 08
11.10Integracja z VS CodeKonfiguracja integracji MCP z VS Code i korzystanie z AI ChatLab 09
11.11Strategie wdrożenioweWdrożenie za pomocą Dockera, Azure Container Apps i skalowanieLab 10
11.12MonitorowanieApplication Insights, logowanie, monitorowanie wydajnościLab 11
11.13Najlepsze praktykiOptymalizacja wydajności, wzmacnianie bezpieczeństwa i wskazówki produkcyjneLab 12

💻 Przykładowe projekty kodu

Podstawowe przykłady kalkulatora MCP

JęzykOpisLink
C#Przykład serwera MCPZobacz kod
JavaKalkulator MCPZobacz kod
JavaScriptDemo MCPZobacz kod
PythonSerwer MCPZobacz kod
TypeScriptPrzykład MCPZobacz kod
RustPrzykład MCPZobacz kod

Zaawansowane implementacje MCP

JęzykOpisLink
C#Zaawansowany przykładZobacz kod
Java z SpringPrzykład aplikacji kontenerowejZobacz kod
JavaScriptZaawansowany przykładZobacz kod
PythonZłożona implementacjaZobacz kod
TypeScriptPrzykład konteneraZobacz kod

🎯 Wymagania wstępne do nauki MCP

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

📚 Przewodnik nauki i zasoby

To repozytorium zawiera różnorodne zasoby, które pomogą Ci efektywnie się uczyć:

Przewodnik nauki

Dostępny jest kompleksowy Przewodnik nauki, który pomoże Ci skutecznie 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 umiejętności
  • Dodatkowe zasoby uzupełniające Twoją podróż edukacyjną

Dziennik zmian

Prowadzimy szczegółowy Dziennik zmian, który śledzi wszystkie istotne aktualizacje materiałów programowych, w tym:

  • Dodanie nowej treści
  • Zmiany strukturalne
  • Ulepszenia funkcji
  • Aktualizacje dokumentacji

🛠️ Jak efektywnie korzystać z tego programu nauczania

Każda lekcja w tym przewodniku zawiera:

  1. Jasne wyjaśnienia koncepcji MCP
  2. Przykłady kodu na żywo w różnych językach
  3. Ćwiczenia do tworzenia rzeczywistych aplikacji MCP
  4. Dodatkowe zasoby dla zaawansowanych uczniów

Wydarzenia

MCP Dev Days Lipiec 2025

➡️ Obejrzyj na żądanie - MCP Dev Days

Przygotuj się na dwa dni głębokich wglądów technicznych, połączeń 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.

Dzień 1: Produktywność MCP, narzędzia deweloperskie i społeczność:

Skupia się na umożliwieniu deweloperom korzystania z MCP w ich 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 zobaczyć, jak współpracują z Microsoftem, kształtując 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 deweloperskie
Sesje prowadzone przez społeczność i wglądy
Niezależnie od tego, czy dopiero zaczynasz z MCP, czy już z nim budujesz, Dzień 1 dostarczy inspiracji i praktycznych wskazówek.

Dzień 2: Budowanie serwerów MCP z pewnością

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.

Tematy obejmują:

  • Tworzenie serwerów MCP i ich integracja z doświadczeniami agentów
  • Rozwój oparty na promptach
  • Najlepsze praktyki 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ś deweloperem, twórcą narzędzi lub strategiem produktów AI, ten dzień jest pełen wglądów, które pomogą Ci budować skalowalne, bezpieczne i przyszłościowe rozwiązania MCP.

MCP Boot Camp Sierpień 2025

Naucz się w intensywnych sesjach wideo, jak tworzyć serwery MCP, integrować z VS Code i profesjonalnie wdrażać na Azure, bazując na treściach z programu MCP dla początkujących. Zdobądź praktyczne umiejętności w technologii, którą już wykorzystują największe firmy.

➡️ Obejrzyj na żądanie MCP Bootcamp | Angielski

➡️ Obejrzyj na żądanie MCP Bootcamp | Brazylia

➡️ Obejrzyj na żądanie MCP Bootcamp | Hiszpański

Nauczmy się MCP z C# - Seria tutoriali

Poznaj Model Context Protocol (MCP), nowoczesne ramy zaprojektowane do standaryzacji interakcji między modelami AI a aplikacjami klienckimi. W tej sesji przyjaznej dla początkujących wprowadzimy Cię w MCP i poprowadzimy przez tworzenie pierwszego serwera MCP.

C#: https://aka.ms/letslearnmcp-csharp

Java: https://aka.ms/letslearnmcp-java

JavaScript: https://aka.ms/letslearnmcp-javascript

Python: https://aka.ms/letslearnmcp-python

🌟 Podziękowania społeczności

Podziękowania dla Microsoft Valued Professional Shivam Goyal za wkład w ważne przykłady kodu.

📜 Informacje o licencji

Treść ta jest licencjonowana na podstawie MIT License. Warunki i zasady znajdziesz w LICENSE.

🤝 Wytyczne dotyczące wkładu

Ten projekt przyjmuje wkłady i sugestie. Większość wkładów wymaga zgody na
Umowę Licencyjną Współtwórcy (CLA), która deklaruje, że masz prawo do udzielenia 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.

📂 Struktura repozytorium

Repozytorium jest zorganizowane w następujący sposób:

  • Core Curriculum (00-11): Główna treść zorganizowana w jedenaście kolejnych modułów, w tym kompleksowe laboratoria integracji bazy danych
  • 11-MCPServerHandsOnLabs/: Kompletny 13-laboratoryjny program nauki budowania gotowych do produkcji serwerów MCP z integracją PostgreSQL
  • 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 programowych
  • mcp.json: Plik konfiguracyjny dla specyfikacji MCP
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Dokumenty dotyczące zarządzania projektem

🎒 Inne kursy

Nasz zespół tworzy inne kursy! Sprawdź:

™️ Informacja o znakach towarowych

Ten projekt może zawierać znaki towarowe lub logotypy związane z projektami, produktami lub usługami. Autoryzowane użycie znaków towarowych lub logotypów Microsoftu podlega i musi być zgodne z
Wytycznymi dotyczącymi znaków towarowych i marki Microsoft.
Użycie znaków towarowych lub logotypów Microsoftu w zmodyfikowanych wersjach tego projektu nie może powodować zamieszania ani sugerować sponsorowania przez Microsoft.
Jakiekolwiek użycie znaków towarowych lub logotypów stron trzecich podlega politykom tych stron trzecich.

Uzyskiwanie pomocy

Jeśli utkniesz lub masz pytania dotyczące budowania aplikacji AI, dołącz do:

Azure AI Foundry Discord

Jeśli masz uwagi dotyczące produktu lub napotkasz błędy podczas budowania, odwiedź:

Azure AI Foundry Developer Forum


Zastrzeżenie:
Ten dokument został przetłumaczony za pomocą usługi tłumaczenia 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 języku źródłowym powinien być uznawany za wiarygodne źródło. W przypadku informacji o kluczowym znaczeniu zaleca się skorzystanie z profesjonalnego tłumaczenia przez człowieka. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z użycia tego tłumaczenia.