wehub-resource-sync
34 KiB
Follow these steps to get started using these resources:
- Fork the Repository: Click
- Clone the Repository:
git clone https://github.com/microsoft/mcp-for-beginners.git - Join The
🌐 Multi-Language Support
Supported via GitHub Action (Automated & Always Up-to-Date)
Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Estonian | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Kannada | Khmer | Korean | Lithuanian | Malay | Malayalam | Marathi | Nepali | Nigerian Pidgin | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Tamil | Telugu | Thai | Turkish | Ukrainian | Urdu | Vietnamese
Prefer to Clone Locally?
This repository includes 50+ language translations which significantly increases the download size. To clone without translations, use sparse checkout:
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"This gives you everything you need to complete the course with a much faster download.
🚀 Model Context Protocol (MCP) Curriculum for Beginners
Learn MCP with Hands-on Code Examples in C#, Java, JavaScript, Rust, Python, and TypeScript
🧠 Overview of the Model Context Protocol Curriculum
Welcome to your journey into the Model Context Protocol! If you've ever wondered how AI applications communicate with different tools and services, you're about to discover the elegant solution that's transforming how developers build intelligent systems.
Think of MCP as a universal translator for AI applications - just like how USB ports let you connect any device to your computer, MCP lets AI models connect to any tool or service in a standardized way. Whether you're building your first chatbot or working on complex AI workflows, understanding MCP will give you the power to create more capable and flexible applications.
This curriculum is designed with patience and care for your learning journey. We'll start with simple concepts you already understand and gradually build your expertise through hands-on practice in your favorite programming language. Every step includes clear explanations, practical examples, and plenty of encouragement along the way.
By the time you complete this journey, you'll have the confidence to build your own MCP servers, integrate them with popular AI platforms, and understand how this technology is reshaping the future of AI development. Let's begin this exciting adventure together!
Official Documentation and Specifications
This curriculum is aligned with MCP Specification 2025-11-25 (the latest stable release). The MCP specification uses date-based versioning (YYYY-MM-DD format) to ensure clear protocol version tracking.
These resources become more valuable as your understanding grows, but don't feel pressured to read everything immediately. Start with the areas that interest you most!
- 📘 MCP Documentation – This is your go-to resource for step-by-step tutorials and user guides. The documentation is written with beginners in mind, providing clear examples you can follow along with at your own pace.
- 📜 MCP Specification – Think of this as your comprehensive reference manual. As you work through the curriculum, you'll find yourself returning here to look up specific details and explore advanced features.
- 📜 MCP Specification Versioning – This contains information about protocol version history and how MCP uses date-based versioning (YYYY-MM-DD format).
- 🧑💻 MCP GitHub Repository – Here you'll find SDKs, tools, and code samples in multiple programming languages. It's like a treasure trove of practical examples and ready-to-use components.
- 🌐 MCP Community – Join fellow learners and experienced developers in discussions about MCP. It's a supportive community where questions are welcome and knowledge is shared freely.
Learning Objectives
By the end of this curriculum, you'll feel confident and excited about your new abilities. Here's what you'll achieve:
• Understand MCP fundamentals: You'll grasp what the Model Context Protocol is and why it's revolutionizing how AI applications work together, using analogies and examples that make sense.
• Build your first MCP server: You'll create a working MCP server in your preferred programming language, starting with simple examples and growing your skills step by step.
• Connect AI models to real tools: You'll learn how to bridge the gap between AI models and actual services, giving your applications powerful new capabilities.
• Implement security best practices: You'll understand how to keep your MCP implementations safe and secure, protecting both your applications and your users.
• Deploy with confidence: You'll know how to take your MCP projects from development to production, with practical deployment strategies that work in the real world.
• Join the MCP community: You'll become part of a growing community of developers who are shaping the future of AI application development.
Essential Background
Before we dive into MCP specifics, let's make sure you feel comfortable with some foundational concepts. Don't worry if you're not an expert in these areas - we'll explain everything you need to know as we go!
Understanding Protocols (The Foundation)
Think of a protocol like the rules for a conversation. When you call a friend, you both know to say "hello" when you answer, take turns speaking, and say "goodbye" when you're done. Computer programs need similar rules to communicate effectively.
MCP na protocol - na set of rules wey dem agree for make AI models and applications fit yarn well wit tools and services. Just like how get rules for talkin dey make human talk beta, get MCP dey make AI application talk beta and strong well-well.
Client-Server Relationships (How Programs Work Together)
You dey use client-server relationships everyday! Wen you dey use web browser (di client) go website, you dey connect to web server wey dey send you di page content. Di browser sabi how to ask for info, server sabi how to answer.
For MCP, e be dat kind relationship: AI models dey act like clients wey dey request info or action, meanwhile MCP servers dey provide di wahala. E be like say server be beta helper wey AI fit ask to do some specific work.
Why Standardization Matters (Making Things Work Together)
Imagine say every car company dey use different shape fuel pump - you go need different adapter for each car! Standardization mean say everybody gree for one correct way so that all tins fit work together smoothly.
MCP dey give dat standardization for AI apps. Instead make every AI model need custom code to fit use every tool, MCP create better way for all of dem to yan. This one fit help developers to build tools once and make am work with plenty AI systems.
🧭 Your Learning Path Overview
Your MCP journey smooth and dem arrange am to make your confidence and skills grow steadily. Every phase go show new tins plus make you remember wetin you don sabi before.
🌱 Foundation Phase: Understanding the Basics (Modules 0-2)
Na here your journey start! We go show you MCP concepts with easy pikin tok and simple examples. You go understand wetin MCP be, why e dey, and how e take fit for AI world.
• Module 0 - Introduction to MCP: We go start by show you wetin MCP be and why e important for modern AI apps. You go see real MCP examples and how e dey solve wahala wey developers dey face.
• Module 1 - Core Concepts Explained: Here you go learn di necessary building blocks of MCP. We go use plenty analogies and picture examples to make sure say dis concepts clear for you.
• Module 2 - Security in MCP: Security fit sound fear, but we go show you how MCP get built-in safety features and teach you better ways to protect your apps from start.
🔨 Building Phase: Creating Your First Implementations (Module 3)
Now di real fun don start! You go get hands-on experience to build real MCP servers and clients. No worry - we go start from small and waka you through every step.
Dis module get plenty hands-on guides wey go make you practice for your preferred programming language. You go create your first server, build client to connect to am, and even join popular development tools like VS Code.
Every guide get full code examples, troubleshooting tips, and explanations why we take certain design choices. By di time you finish dis phase, you go get working MCP implementations wey you fit proud of!
🚀 Growing Phase: Advanced Concepts and Real-World Application (Modules 4-5)
When you don sabi basics well, you ready to explore more sophisticated MCP features. We go talk about practical implementation strategies, debugging techniques, and advanced topics like multi-modal AI integration.
You go still learn how to scale your MCP implementations for production use and join with cloud platforms like Azure. These modules go prepare you to build MCP solutions wey fit handle real-world demands.
🌟 Mastery Phase: Community and Specialization (Modules 6-11)
Di last phase focus on how you join MCP community and specialize in areas wey dey interest you well well. You go learn how to contribute to open-source MCP projects, implement advanced authentication patterns, and build complete database-integrated solutions.
Module 11 deserve special mention - na complete 13-lab hands-on learning path wey teach you to build production-ready MCP servers with PostgreSQL integration. E be like capstone project wey bring together everything wey you don learn!
📚 Complete Curriculum Structure
| Module | Topic | Description | Link |
|---|---|---|---|
| Module 0-3: Fundamentals | |||
| 00 | Introduction to MCP | Overview of di Model Context Protocol and why e matter for AI pipelines | Read more |
| 01 | Core Concepts Explained | Deep talk about core MCP concepts | Read more |
| 02 | Security in MCP | Security threats and best practices | Read more |
| 03 | Getting Started with MCP | Environment setup, basic servers/clients, integration | Read more |
| Module 3: Building Your First Server & Client | |||
| 3.1 | First Server | Create your first MCP server | Guide |
| 3.2 | First Client | Develop basic MCP client | Guide |
| 3.3 | Client with LLM | Join large language models together | Guide |
| 3.4 | VS Code Integration | Use MCP servers inside VS Code | Guide |
| 3.5 | stdio Server | Create servers using stdio transport | Guide |
| 3.6 | HTTP Streaming | Implement HTTP streaming for MCP | Guide |
| 3.7 | Microsoft Foundry Toolkit | Use Microsoft Foundry Toolkit with MCP | Guide |
| 3.8 | Testing | Test your MCP server implementation | Guide |
| 3.9 | Deployment | Deploy MCP servers for production | Guide |
| 3.10 | Advanced server usage | Use advanced servers for better features and architecture | Guide |
| 3.11 | Simple auth | Chapter wey show you authentication from beginning and RBAC | Guide |
| 3.12 | MCP Hosts | Configure Claude Desktop, Cursor, Cline, and other MCP hosts | Guide |
| 3.13 | MCP Inspector | Debug and test MCP servers with Inspector tool | Guide |
| 3.14 | Sampling | Use sampling to collaborate with client | Guide |
| 3.15 | MCP Apps | Build MCP Apps | Guide |
| Module 4-5: Practical & Advanced | |||
| 04 | Practical Implementation | SDKs, debugging, testing, reusable prompt templates | Read more |
| 4.1 | Pagination | Handle big result sets with cursor-based pagination | Guide |
| 05 | Advanced Topics in MCP | Multi-modal AI, scaling, enterprise use | Read more |
| 5.1 | Azure Integration | MCP join with Azure | Guide |
| 5.2 | Multi-modality | Work with many different modalities | Guide |
| 5.3 | OAuth2 Demo | Implement OAuth2 authentication | Guide |
| 5.4 | Root Contexts | Understand and implement root contexts | Guide |
| 5.5 | Routing | MCP routing strategies | Guide |
| 5.6 | Sampling | Sampling techniques for MCP | Guide |
| 5.7 | Scaling | Scale MCP implementations | Guide |
| 5.8 | Security | Advanced security topics | Guide |
| 5.9 | Web Search | Implement web search abilities | Guide |
| 5.10 | Realtime Streaming | Build realtime streaming features | Guide |
| 5.11 | Realtime Search | Implement realtime search | Guide |
| 5.12 | Entra ID Auth | Authentication with Microsoft Entra ID | Guide |
| 5.13 | Foundry Integration | Join with Microsoft Foundry | Guide |
| 5.14 | Context Engineering | Techniques for better context engineering | Guide |
| 5.15 | MCP Custom Transport | Custom Transport implementations | Guide |
| 5.16 | Protocol Features | Progress notifications, cancellation, resource templates | Guide |
| 5.17 | Adversarial Multi-Agent Reasoning | Two agents argue mpo sides using shared MCP tools, judge-agent dey evaluate | Guide |
| Module 6-10: Community & Best Practices | |||
| 06 | Community Contributions | How to contribute to MCP ecosystem | Guide |
| 07 | Insights from Early Adoption | Real-world implementation stories | Guide |
| 08 | Best Practices for MCP | Performance, fault-tolerance, resilience | Guide |
| 09 | MCP Case Studies | Practical implementation examples | Guide |
| 10 | Hands-on Workshop | Build MCP Server with Microsoft Foundry Toolkit | Lab |
| Module 11: MCP Server Hands On Lab | |||
| 11 | MCP Server Database Integration | Complete 13-lab hands-on learning path for PostgreSQL integration | Labs |
| 11.1 | Introduction | Overview of MCP with database integration and retail analytics case | Lab 00 |
| 11.2 | Core Architecture | Understand MCP server architecture, database layers, security patterns | Lab 01 |
| 11.3 | Security & Multi-Tenancy | Row Level Security, authentication, multi-tenant data access | Lab 02 |
| 11.4 | Environment Setup | Set development environment, Docker, Azure resources | Lab 03 |
| 11.5 | Database Design | PostgreSQL setup, retail schema design, sample data | Lab 04 |
| 11.6 | MCP Server Implementation | Build FastMCP server with database integration | Lab 05 |
| 11.7 | Tool Development | Create database query tools and schema introspection | Lab 06 |
| 11.8 | Semantic Search | Implement vector embeddings with Azure OpenAI and pgvector | Lab 07 |
| 11.9 | Testing & Debugging | Testing strategies, debugging tools, validation approaches | Lab 08 |
| 11.10 | VS Code Integration | Configure VS Code MCP integration and AI Chat use | Lab 09 |
| 11.11 | Deployment Strategies | Docker deployment, Azure Container Apps, scaling considerations | Lab 10 |
| 11.12 | Monitoring | Application Insights, logging, performance monitoring | Lab 11 |
| 11.13 | Best Practices | Performance optimization, security hardening, production tips | Lab 12 |
| Module 12: MCP Tooling | |||
| 12.1 | Tooling | Use MCP inside Copilot App | Guide |
💻 Sample Code Projects
One of di most exciting part of learning MCP na to see your code skills dey improve step by step. We design our code examples to start simple and grow more advanced as your understanding deepen. Na so we dey introduce concepts - code wey easy to understand but show real MCP principles, you go understand not just wetin this code dey do, but why e set like dat and how e fit inside bigger MCP applications.
Basic MCP Calculator Samples
| Language | Description | Link |
|---|---|---|
| C# | MCP Server Example | View Code |
| Java | MCP Calculator | View Code |
| JavaScript | MCP Demo | View Code |
| Python | MCP Server | View Code |
| TypeScript | MCP Example | View Code |
| Rust | MCP Example | View Code |
Advanced MCP Implementations
| Language | Description | Link |
|---|---|---|
| C# | Advanced Sample | View Code |
| Java with Spring | Container App Example | View Code |
| JavaScript | Advanced Sample | View Code |
| Python | Complex Implementation | View Code |
| TypeScript | Container Sample | View Code |
🎯 Prerequisites for Learning MCP
To get di most out of dis curriculum, you suppose get:
-
Basic knowledge for programming for at least one of dis kine languages: C#, Java, JavaScript, Python, or TypeScript
-
Understanding of client-server model and APIs
-
Familiarity with REST and HTTP concepts
-
(Optional) Background for AI/ML concepts
-
Joining our community discussions for support
📚 Study Guide & Resources
Dis repository get plenty resources to help you navigate and learn well well:
Study Guide
A complete Study Guide dey to help you navigate dis repository well well. Dis visual curriculum map show how all di topics connect and give guide on how to use di sample projects well. E good well well if you like see di koko for eye.
Di guide get:
- Visual curriculum map wey show all topics wey dem cover
- Detailed breakdown of each repository section
- Guide on how to use sample projects
- Recommended learning paths for different skill levels
- Extra resources to add to your learning journey
Changelog
We dey keep detailed Changelog wey dey track all di important updates to di curriculum materials, so you fit dey updated wit di latest improvements and additions.
- New content wey dem add
- Structural changes
- Feature improvements
- Documentation updates
🛠️ How to Use This Curriculum Effectively
Each lesson for dis guide get:
- Clear explanations of MCP concepts
- Live code examples for different languages
- Exercises to build real MCP applications
- Extra resources for advanced learners
Make We Learn MCP with C# - Tutorial Series
Make we learn about Model Context Protocol (MCP), dis na new framework to make AI models and client apps dem sabi talk well. For dis beginner-friendly session, we go show you MCP and guide you to create your first 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
🎓 Your MCP Journey Begins
Congrats! You don just take di first step for beta journey wey go expand your programming skills and connect you to di cutting edge of AI development.
Wetin You Don Already Do
As you don read dis introduction, you don start to build your MCP knowledge base. You sabi wetin MCP be, why e matter, and how dis curriculum go help you learn well. Na big achievement dis and e be di start of your expertise for dis important technology.
The Adventure Ahead
As you dey move through di modules, no forget say every expert na once beginner. Di concepts wey fit look hard now go turn like something you sabi well as you dey practice and apply them. Every small step dey build powerful skills wey go serve you well for your development career.
Your Support Network
You dey join community of learners and experts wey get passion for MCP and dey ready to help others succeed. Whether you dey stuck for coding challenge or you wan share breakthrough, di community dey here to support your journey.
If you jam problem or get questions about building AI apps, join other learners and experienced developers for MCP discussion. Na supportive community where questions dey welcome and knowledge dey shared free free.
If you get product feedback or errors as you dey build, visit:
Ready to Begin?
Your MCP journey don start now! Begin with Module 0 to dive into your first hands-on MCP experiences, or check di sample projects to see wetin you go dey build. Remember - every expert start exactly where you dey now, and with patience and practice, you go impress with wetin you fit do.
Welcome to the world of Model Context Protocol development. Make we build beta tings together!
🤝 Contributing to the Learning Community
Dis curriculum dey grow strong as learners like you dey add their own! Whether you dey fix typo, suggest clearer explanation, or add new example, your contributions dey help other beginners succeed.
Thanks to Microsoft Valued Professional Shivam Goyal for adding code samples.
Di contribution process dey friendly and supportive. Most contributions go need Contributor License Agreement (CLA), but di automated tools go guide you well.
📜 Open Source Learning
Dis whole curriculum dey available under di MIT LICENSE, meaning you fit use, modify, and share am freely. Dis support our mission to make MCP knowledge reachable to developers everywhere.
🤝 Contribution Guidelines
Dis project dey welcome contributions and suggestions. Most contributions go require you to agree to a Contributor License Agreement (CLA) wey talk say you get right, and actually dey give us di rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
When you submit pull request, CLA bot go automatically check if you need provide CLA and decorate di PR well (e.g., status check, comment). Just follow wetin the bot talk. You go only need do this one time for all repos wey use our CLA.
This project don adopt di Microsoft Open Source Code of Conduct. For more info see di Code of Conduct FAQ or contact opencode@microsoft.com if you get any questions or comments.
Ready to start your MCP journey? Begin with Module 00 - Introduction to MCP and take your first steps into di world of Model Context Protocol development!
🎒 Other Courses
Our team dey produce other courses! Check am out:
LangChain
Azure / Edge / MCP / Agents
Generative AI Series
-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA){kind=icon}
-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC){kind=icon}
-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9){kind=icon}
Core Learning
Copilot Series
Disclaimer: Dis document don translate wit AI translation service Co-op Translator. Even tho we dey try make am correct, abeg make you know say automated translation fit get errors or mistakes. Di original document for dia own language na im be di correct source. For important info, make person wey sabi human translation do am. We no go responsible for any misunderstanding or wrong understanding wey fit happen because of dis translation.