wehub/microsoft--mcp-for-beginners

Fork 0

Files

T

wehub-resource-sync c275ba2868 chore: import upstream snapshot with attribution

2026-07-13 13:31:35 +08:00

36 KiB

Raw Permalink Blame History

Följ dessa steg för att komma igång med dessa resurser:

Fork:a Repositoryt: Klicka på
Klona Repositoryt: git clone https://github.com/microsoft/mcp-for-beginners.git
Gå med i

🌐 Stöd för flera språk

Stöds via GitHub Action (Automatiserat & Alltid Uppdaterat)

Föredrar du att klona lokalt?

Detta repository innehåller över 50 språköversättningar som avsevärt ökar nedladdningsstorleken. För att klona utan översättningar, använd sparsamt urval:

Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'
CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"
Detta ger dig allt du behöver för att slutföra kursen med en mycket snabbare nedladdning.

🚀 Model Context Protocol (MCP) Kursplan för nybörjare

Lär dig MCP med praktiska kodexempel i C#, Java, JavaScript, Rust, Python och TypeScript

🧠 Översikt över Model Context Protocol-kursplanen

Välkommen på din resa in i Model Context Protocol! Om du någonsin undrat hur AI-applikationer kommunicerar med olika verktyg och tjänster, är du på väg att upptäcka den eleganta lösningen som förändrar hur utvecklare bygger intelligenta system.

Tänk på MCP som en universell översättare för AI-applikationer – precis som USB-portar låter dig ansluta vilken enhet som helst till din dator, låter MCP AI-modeller ansluta till vilket verktyg eller tjänst som helst på ett standardiserat sätt. Oavsett om du bygger din första chatbot eller arbetar med komplexa AI-arbetsflöden kommer förståelsen för MCP att ge dig kraften att skapa mer kapabla och flexibla applikationer.

Den här kursplanen är utformad med tålamod och omsorg för din läranderesa. Vi börjar med enkla koncept som du redan förstår och bygger gradvis din expertis genom praktisk övning i ditt favoritprogramspråk. Varje steg innehåller tydliga förklaringar, praktiska exempel och mycket uppmuntran på vägen.

När du har slutfört denna resa kommer du att ha självförtroendet att bygga dina egna MCP-servrar, integrera dem med populära AI-plattformar och förstå hur denna teknik omformar AI-utvecklingens framtid. Låt oss börja detta spännande äventyr tillsammans!

Officiell dokumentation och specifikationer

Den här kursplanen är anpassad efter MCP Specification 2025-11-25 (den senaste stabila releasen). MCP-specifikationen använder datum-baserad versionshantering (YYYY-MM-DD-format) för att säkerställa tydlig spårning av protokollversioner.

Dessa resurser blir mer värdefulla i takt med att din förståelse växer, men känn ingen press att läsa allt omedelbart. Börja med de områden som intresserar dig mest!

📘 MCP-dokumentation – Detta är din resurs för steg-för-steg-handledning och användarguider. Dokumentationen är skriven med nybörjare i åtanke och erbjuder tydliga exempel som du kan följa i din egen takt.
📜 MCP-specifikation – Tänk på denna som din omfattande referensmanual. När du arbetar genom kursplanen kommer du att återkomma hit för att slå upp specifika detaljer och utforska avancerade funktioner.
📜 MCP-specifikations versionshantering – Här finns information om protokollversionernas historik och hur MCP använder datum-baserad versionshantering (YYYY-MM-DD-format).
🧑‍💻 MCP GitHub Repository – Här hittar du SDK:er, verktyg och kodexempel i flera programspråk. Det är som en skattkista med praktiska exempel och komponenter som är redo att användas.
🌐 MCP Community – Gå med i andra lärande och erfarna utvecklare i diskussioner om MCP. Det är en stödjande gemenskap där frågor är välkomna och kunskap delas fritt.

Lärandemål

I slutet av denna kursplan kommer du att känna dig säker och entusiastisk över dina nya kunskaper. Här är vad du kommer att uppnå:

• Förstå MCP-grunderna: Du kommer att inse vad Model Context Protocol är och varför det revolutionerar hur AI-applikationer samarbetar, med hjälp av analogier och exempel som är lätta att förstå.

• Bygg din första MCP-server: Du skapar en fungerande MCP-server i ditt föredragna programspråk, med början från enkla exempel och utvecklas steg för steg.

• Koppla AI-modeller till riktiga verktyg: Du lär dig hur du överbryggar klyftan mellan AI-modeller och faktiska tjänster, vilket ger dina applikationer kraftfulla nya möjligheter.

• Implementera säkerhetsbästa praxis: Du förstår hur du håller dina MCP-implementationer säkra, och skyddar både dina applikationer och användare.

• Distribuera med självförtroende: Du vet hur du tar dina MCP-projekt från utveckling till produktion, med praktiska distributionsstrategier som fungerar i verkligheten.

• Gå med i MCP-gemenskapen: Du blir en del av en växande gemenskap av utvecklare som formar AI-applikationsutvecklingens framtid.

Nödvändig bakgrund

Innan vi dyker in i MCP-specifika detaljer, låt oss se till att du känner dig bekväm med några grundläggande koncept. Oroa dig inte om du inte är expert inom dessa områden – vi förklarar allt du behöver veta längs vägen!

Förstå protokoll (grunden)

Tänk på ett protokoll som reglerna för en konversation. När du ringer en vän vet ni båda att man säger "hej" när man svarar, turas om att prata och säger "hejdå" när man är klar. Datorprogram behöver liknande regler för att kommunicera effektivt.

MCP är ett protokoll — en uppsättning överenskomna regler som hjälper AI-modeller och applikationer att ha produktiva "samtal" med verktyg och tjänster. Precis som samtalsregler gör människokommunikation smidigare, gör MCP AI-applikationskommunikation mycket mer pålitlig och kraftfull.

Klient-server-relationer (hur program samarbetar)

Du använder redan klient-server-relationer varje dag! När du använder en webbläsare (klienten) för att besöka en webbplats, ansluter du till en webbserver som skickar sida innehållet. Webbläsaren vet hur den ska be om information och servern vet hur den ska svara.

I MCP har vi en liknande relation: AI-modeller agerar som klienter som begär information eller handlingar, medan MCP-servrar tillhandahåller dessa funktioner. Det är som att ha en hjälpsam assistent (servern) som AI:n kan be utföra specifika uppgifter.

Varför standardisering är viktigt (få saker att fungera tillsammans)

Föreställ dig att varje biltillverkare använde olika formade bensinpumpar – du skulle behöva en annan adapter för varje bil! Standardisering innebär att man enas om gemensamma tillvägagångssätt så att saker fungerar tillsammans sömlöst.

MCP erbjuder denna standardisering för AI-applikationer. Istället för att varje AI-modell behöver specialkod för att fungera med varje verktyg, skapar MCP ett universellt sätt för dem att kommunicera. Det betyder att utvecklare kan bygga verktyg en gång och få dem att fungera med många olika AI-system.

🧭 Din lärandeväg Översikt

Din MCP-resa är noggrant strukturerad för att gradvis bygga ditt självförtroende och dina färdigheter. Varje fas introducerar nya koncept samtidigt som tidigare lärdomar befästs.

🌱 Grundfas: Förstå grunderna (Moduler 0-2)

Här börjar ditt äventyr! Vi introducerar dig till MCP-koncept med välbekanta analogier och enkla exempel. Du kommer att förstå vad MCP är, varför det finns, och hur det passar in i den större världen av AI-utveckling.

• Modul 0 - Introduktion till MCP: Vi börjar med att utforska vad MCP är och varför det är så viktigt för moderna AI-applikationer. Du får se verkliga exempel på MCP i praktiken och förstår hur det löser vanliga problem som utvecklare stöter på.

• Modul 1 - Kärnkoncept förklarade: Här lär du dig MCP:s viktiga byggstenar. Vi använder mängder av analogier och visuella exempel för att säkerställa att dessa koncept känns naturliga och begripliga.

• Modul 2 - Säkerhet i MCP: Säkerhet kan låta skrämmande, men vi visar dig hur MCP inkluderar inbyggda säkerhetsfunktioner och lär ut bästa praxis som skyddar dina applikationer från början.

🔨 Byggfas: Skapa dina första implementationer (Modul 3)

Nu börjar det verkliga roliga! Du kommer att få praktisk erfarenhet av att bygga faktiska MCP-servrar och klienter. Oroa dig inte – vi börjar enkelt och vägleder dig genom varje steg.

Denna modul innehåller flera praktiska guider som låter dig öva i ditt föredragna programmeringsspråk. Du kommer att skapa din första server, bygga en klient för att ansluta till den och till och med integrera med populära utvecklingsverktyg som VS Code.

Varje guide inkluderar kompletta kodexempel, felsökningstips och förklaringar till varför vi gör specifika designval. I slutet av denna fas kommer du att ha fungerande MCP-implementationer som du kan vara stolt över!

🚀 Växande fas: Avancerade koncept och verklig tillämpning (Moduler 4-5)

Med grunderna härskade är du redo att utforska mer sofistikerade MCP-funktioner. Vi täcker praktiska implementeringsstrategier, felsökningstekniker och avancerade ämnen som multimodal AI-integration.

Du kommer också att lära dig hur du skalar dina MCP-implementationer för produktionsanvändning och integrerar med molnplattformar som Azure. Dessa moduler förbereder dig för att bygga MCP-lösningar som kan hantera verkliga krav.

🌟 Mästarfas: Gemenskap och specialisering (Moduler 6-11)

Den sista fasen fokuserar på att gå med i MCP-gemenskapen och specialisera dig inom områden som intresserar dig mest. Du kommer att lära dig att bidra till open source MCP-projekt, implementera avancerade autentiseringsmönster och bygga omfattande databas-integrerade lösningar.

Modul 11 förtjänar särskild uppmärksamhet – det är en komplett 13-labs praktisk lärandeväg som lär dig att bygga produktionsklara MCP-servrar med PostgreSQL-integration. Det är som ett slutprojekt som knyter ihop allt du har lärt dig!

📚 Komplett kursstruktur

Modul	Ämne	Beskrivning	Länk
Modul 0-3: Grunderna
00	Introduktion till MCP	Översikt av Model Context Protocol och dess betydelse i AI-pipelines	Läs mer
01	Grundläggande begrepp förklarade	Djupdykning i kärnbegrepp inom MCP	Läs mer
02	Säkerhet i MCP	Säkerhetshot och bästa praxis	Läs mer
03	Kom igång med MCP	Miljöuppsättning, grundläggande servrar/klienter, integration	Läs mer
Modul 3: Bygg din första server & klient
3.1	Första server	Skapa din första MCP-server	Guide
3.2	Första klient	Utveckla en grundläggande MCP-klient	Guide
3.3	Klient med LLM	Integrera stora språkmodeller	Guide
3.4	VS Code-integration	Använd MCP-servrar i VS Code	Guide
3.5	stdio-server	Skapa servrar med stdio-transport	Guide
3.6	HTTP-streaming	Implementera HTTP-streaming i MCP	Guide
3.7	Microsoft Foundry Toolkit	Använd Microsoft Foundry Toolkit med MCP	Guide
3.8	Testning	Testa din MCP-serverimplementation	Guide
3.9	Distribution	Distribuera MCP-servrar till produktion	Guide
3.10	Avancerad serveranvändning	Använd avancerade servrar för avancerade funktioner och förbättrad arkitektur	Guide
3.11	Enkel autentisering	Ett kapitel som visar autentisering från början och RBAC	Guide
3.12	MCP-värdar	Konfigurera Claude Desktop, Cursor, Cline och andra MCP-värdar	Guide
3.13	MCP Inspector	Felsök och testa MCP-servrar med Inspector-verktyget	Guide
3.14	Sampling	Använd sampling för samarbete med klienten	Guide
3.15	MCP-appar	Bygg MCP-appar	Guide
Modul 4-5: Praktiskt & avancerat
04	Praktisk implementation	SDK:er, felsökning, testning, återanvändbara promptmallar	Läs mer
4.1	Paginering	Hantera stora resultatmängder med cursor-baserad paginering	Guide
05	Avancerade ämnen i MCP	Multimodal AI, skalning, företagsanvändning	Läs mer
5.1	Azure-integration	MCP-integration med Azure	Guide
5.2	Multimodalitet	Arbeta med flera modaliteter	Guide
5.3	OAuth2-demo	Implementera OAuth2-autentisering	Guide
5.4	Rötter Kontext	Förstå och implementera root contexts	Guide
5.5	Routing	MCP-routningsstrategier	Guide
5.6	Sampling	Samplingstekniker i MCP	Guide
5.7	Skalning	Skala MCP-implementationer	Guide
5.8	Säkerhet	Avancerade säkerhetsaspekter	Guide
5.9	Webb-sökning	Implementera webb-sökfunktionalitet	Guide
5.10	Realtidsstreaming	Bygg realtime streaming-funktionalitet	Guide
5.11	Realtidssökning	Implementera realtime-sökning	Guide
5.12	Entra ID-autentisering	Autentisering med Microsoft Entra ID	Guide
5.13	Foundry-integration	Integrera med Microsoft Foundry	Guide
5.14	Kontextteknik	Tekniker för effektiv kontextutformning	Guide
5.15	Anpassad MCP-transport	Implementeringar av anpassad transport	Guide
5.16	Protokollfunktioner	Progressaviseringar, avbokning, resursmallar	Guide
5.17	Adversarial Multi-Agent Reasoning	Två agenter argumenterar motsatta sidor med gemensamma MCP-verktyg, utvärderade av en domare-agent	Guide
Modul 6-10: Gemenskap & bästa praxis
06	Gemenskapsbidrag	Hur man bidrar till MCP-ekosystemet	Guide
07	Insikter från tidig adoption	Verkliga implementeringsberättelser	Guide
08	Bästa praxis för MCP	Prestanda, felförlåtelse, motståndskraft	Guide
09	MCP-fallstudier	Praktiska implementeringsexempel	Guide
10	Praktiskt workshop	Bygga en MCP-server med Microsoft Foundry Toolkit	Lab
Modul 11: MCP Server Praktisk Lab
11	MCP Server Databas-integration	Omfattande 13-labs praktisk lärandeväg för PostgreSQL-integration	Labs
11.1	Introduktion	Översikt av MCP med databas-integration och användningsfall för detaljhandelanalys	Lab 00
11.2	Kärnarkitektur	Förstå MCP-serverarkitektur, databasskikt och säkerhetsmönster	Lab 01
11.3	Säkerhet & Multi-tenancy	Row Level Security, autentisering och multitenant-datatillgång	Lab 02
11.4	Miljöuppsättning	Ställa in utvecklingsmiljö, Docker, Azure-resurser	Lab 03
11.5	Databasdesign	PostgreSQL-uppsättning, detaljhandelschema och exempeldataset	Lab 04
11.6	MCP Serverimplementation	Bygga FastMCP-servern med databas-integration	Lab 05
11.7	Verktygsutveckling	Skapa databassökningsverktyg och schema-introspektion	Lab 06
11.8	Semantisk sökning	Implementera vektorembedding med Azure OpenAI och pgvector	Lab 07
11.9	Testning & felsökning	Teststrategier, felsökningsverktyg och valideringsmetoder	Lab 08
11.10	VS Code-integration	Konfigurera VS Code MCP-integration och användning av AI Chat	Lab 09
11.11	Distributionsstrategier	Docker-distribution, Azure Container Apps och skalningsöverväganden	Lab 10
11.12	Övervakning	Application Insights, loggning, prestandaövervakning	Lab 11
11.13	Bästa praxis	Prestandaoptimering, säkerhetshärdning och produktionstips	Lab 12
Modul 12: MCP-verktyg
12.1	Verktyg	MCP-användning i Copilot App	Guide

💻 Exempelkodsprojekt

En av de mest spännande delarna av att lära sig MCP är att se dina kodkunskaper utvecklas stegvis. Vi har designat våra kodexempel för att börja enkelt och bli mer sofistikerade i takt med att din förståelse fördjupas. Så här introducerar vi koncept – med kod som är lätt att förstå men visar verkliga MCP-principer, kommer du att förstå inte bara vad koden gör, utan varför den är strukturerad så här och hur den passar in i större MCP-applikationer.

Grundläggande MCP-räknare-exempel

Språk	Beskrivning	Länk
C#	MCP-serverexempel	Se kod
Java	MCP-räknare	Se kod
JavaScript	MCP-demo	Se kod
Python	MCP-server	Se kod
TypeScript	MCP-exempel	Se kod
Rust	MCP-exempel	Se kod

Avancerade MCP-implementationer

Språk	Beskrivning	Länk
C#	Avancerat exempel	Se kod
Java med Spring	Containerapp Exempel	Visa kod
JavaScript	Avancerat Exempel	Visa kod
Python	Komplext Implementering	Visa kod
TypeScript	Container Exempel	Visa kod

🎯 Förutsättningar för att lära sig MCP

För att få ut det mesta av detta läroplan bör du ha:

Grundläggande kunskaper i programmering i minst ett av följande språk: C#, Java, JavaScript, Python eller TypeScript
Förståelse för klient-server-modellen och API:er
Kännedom om REST och HTTP-koncept
(Valfritt) Bakgrund inom AI/ML-koncept
Delta i våra gemenskapsdiskussioner för stöd

📚 Studievägledning & Resurser

Detta arkiv innehåller flera resurser för att hjälpa dig att navigera och lära dig effektivt:

Studievägledning

En omfattande Studievägledning finns tillgänglig för att hjälpa dig att navigera detta arkiv effektivt. Denna visuella läroplansöversikt visar hur alla ämnen hänger ihop och ger vägledning om hur du använder exempelprojekten på ett effektivt sätt. Den är särskilt hjälpsam om du är en visuell lärande som gillar att se helheten.

Guiden inkluderar:

En visuell läroplansöversikt som visar alla behandlade ämnen
Detaljerad genomgång av varje avsnitt i arkivet
Vägledning om hur man använder exempelprojekten
Rekommenderade inlärningsvägar för olika kunskapsnivåer
Ytterligare resurser för att komplettera din läranderesa

Ändringslogg

Vi underhåller en detaljerad Ändringslogg som spårar alla viktiga uppdateringar av läromedelsmaterialet, så att du kan hålla dig uppdaterad med de senaste förbättringarna och tilläggen.

Nya innehållstillägg
Strukturella ändringar
Funktionsförbättringar
Dokumentationsuppdateringar

🛠️ Hur du använder denna läroplan effektivt

Varje lektion i denna guide inkluderar:

Tydliga förklaringar av MCP-koncept
Live-exempel i flera programmeringsspråk
Övningar för att bygga riktiga MCP-applikationer
Extra resurser för avancerade användare

Låt oss lära oss MCP med C# - Tutorialsserie

Låt oss lära oss om Model Context Protocol (MCP), ett banbrytande ramverk utformat för att standardisera interaktioner mellan AI-modeller och klientapplikationer. Genom denna nybörjarvänliga session introducerar vi dig till MCP och guidar dig igenom att skapa din första MCP-server.

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

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

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

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

🎓 Din MCP-resa börjar

Grattis! Du har precis tagit det första steget i en spännande resa som kommer att utöka dina programmeringsmöjligheter och koppla dig till den senaste utvecklingen inom AI.

Vad du redan har åstadkommit

Genom att läsa igenom denna introduktion har du redan börjat bygga din kunskapsgrund för MCP. Du förstår vad MCP är, varför det är viktigt och hur denna läroplan kommer att stödja din läranderesa. Det är en betydande prestation och början på din expertis inom denna viktiga teknik.

Äventyret framför dig

När du går vidare genom modulerna, kom ihåg att varje expert en gång var en nybörjare. De koncept som kan verka komplexa nu kommer att bli andra natur när du övar och tillämpar dem. Varje litet steg bygger upp till kraftfulla färdigheter som kommer att tjäna dig genom hela din utvecklingskarriär.

Ditt stödnätverk

Du ansluter dig till en gemenskap av lärande och experter som brinner för MCP och är ivriga att hjälpa andra att lyckas. Oavsett om du fastnar på en kodningsutmaning eller är ivrig att dela en genombrott, finns gemenskapen här för att stödja din resa.

Om du fastnar eller har frågor om att bygga AI-appar, gå med i samtalen med andra elever och erfarna utvecklare om MCP. Det är en stödjande gemenskap där frågor är välkomna och kunskap delas fritt.

Om du har produktfeedback eller fel vid utveckling, besök:

Redo att börja?

Ditt MCP-äventyr börjar nu! Börja med Modul 0 för att dyka ner i dina första praktiska MCP-upplevelser, eller utforska exempelprojekten för att se vad du ska bygga. Kom ihåg – varje expert började precis där du är nu, och med tålamod och övning kommer du att bli förvånad över vad du kan åstadkomma.

Välkommen till världen av Model Context Protocol-utveckling. Låt oss bygga något fantastiskt tillsammans!

🤝 Bidra till lärandegemenskapen

Den här läroplanen blir starkare med bidrag från lärande som du! Oavsett om du rättar ett stavfel, föreslår en tydligare förklaring eller lägger till ett nytt exempel, hjälper dina bidrag andra nybörjare att lyckas.

Tack till Microsoft Valued Professional Shivam Goyal för bidrag med kodexempel.

Bidragsprocessen är utformad för att vara välkomnande och stödjande. De flesta bidrag kräver ett Contributor License Agreement (CLA), men de automatiska verktygen kommer smidigt att leda dig genom processen.

📜 Open Source Lärande

Denna hela läroplan är tillgänglig under MIT LICENSE, vilket betyder att du kan använda, modifiera och dela fritt. Detta stödjer vårt uppdrag att göra MCP-kunskaper tillgängliga för utvecklare överallt.

🤝 Bidragsriktlinjer

Detta projekt välkomnar bidrag och förslag. De flesta bidrag kräver att du godkänner ett Contributor License Agreement (CLA) där du intygar att du har rätt att, och faktiskt gör, bevilja oss rättigheter att använda ditt bidrag. För detaljer, besök https://cla.opensource.microsoft.com.

När du skickar in en pull request kommer en CLA-bot automatiskt att avgöra om du behöver tillhandahålla en CLA och märka PR på lämpligt sätt (t.ex. statuskontroll, kommentar). Följ bara instruktionerna från boten. Du behöver bara göra detta en gång över alla repo som använder vår CLA.

Detta projekt har antagit Microsoft Open Source Code of Conduct. För mer information se Code of Conduct FAQ eller kontakta opencode@microsoft.com med frågor eller kommentarer.

Redo att starta din MCP-resa? Börja med Modul 00 - Introduktion till MCP och ta dina första steg in i världen av Model Context Protocol-utveckling!

🎒 Andra kurser

Vårt team producerar andra kurser! Kolla in:

LangChain

Azure / Edge / MCP / Agenter

Generativ AI-serie

Kärninlärning

Copilot-serien

Ansvarsfriskrivning: Detta dokument har översatts med hjälp av AI-översättningstjänsten Co-op Translator. Även om vi strävar efter noggrannhet, var vänlig notera att automatiska översättningar kan innehålla fel eller brister. Det ursprungliga dokumentet på dess modersmål bör betraktas som den auktoritativa källan. För kritisk information rekommenderas professionell mänsklig översättning. Vi ansvarar inte för några missförstånd eller feltolkningar som uppstår till följd av användningen av denna översättning.

36 KiB Raw Permalink Blame History Unescape Escape