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
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.
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!
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.
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.
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!
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 is a protocol - a set of agreed-upon rules that help AI models and applications have productive "conversations" with tools and services. Just like how having conversation rules makes human communication smoother, having MCP makes AI application communication much more reliable and powerful.
You already use client-server relationships every day! When you use a web browser (the client) to visit a website, you're connecting to a web server that sends you the page content. The browser knows how to ask for information, and the server knows how to respond.
In MCP, we have a similar relationship: AI models act as clients that request information or actions, while MCP servers provide those capabilities. It's like having a helpful assistant (the server) that the AI can ask to perform specific tasks.
Imagine if every car manufacturer used different shaped gas pumps - you'd need a different adapter for each car! Standardization means agreeing on common approaches so things work together seamlessly.
MCP provides this standardization for AI applications. Instead of every AI model needing custom code to work with every tool, MCP creates a universal way for them to communicate. This means developers can build tools once and have them work with many different AI systems.
Your MCP journey is carefully structured to build your confidence and skills progressively. Each phase introduces new concepts while reinforcing what you've already learned.
This is where your adventure begins! We'll introduce you to MCP concepts using familiar analogies and simple examples. You'll understand what MCP is, why it exists, and how it fits into the larger world of AI development.
• Module 0 - Introduction to MCP: We'll start by exploring what MCP is and why it's so important for modern AI applications. You'll see real-world examples of MCP in action and understand how it solves common problems developers face.
• Module 1 - Core Concepts Explained: Here you'll learn the essential building blocks of MCP. We'll use plenty of analogies and visual examples to make sure these concepts feel natural and understandable.
• Module 2 - Security in MCP: Security might sound intimidating, but we'll show you how MCP includes built-in safety features and teach you best practices that protect your applications from the start.
Now di real fun don start! You go get hands-on experience to build correct MCP servers and clients. No wahala - we go start simple and guide you through every step.
Dis module get plenty hands-on guides weh go let you practice for your preferred programming language. You go create your first server, build client weh go connect to am, and even join popular development tools like VS Code.
Each guide get complete code examples, troubleshooting tips, and explanations why we dey make certain design choices. By di end of dis phase, you go get working MCP implementations weh you fit proud of!
After you don sabi the basics, you go ready to explore more advanced MCP features. We go cover practical implementation strategies, debugging techniques, and advanced topics like multi-modal AI integration.
You go also learn how to scale your MCP implementations for production use and join cloud platforms like Azure. These modules go prepare you to build MCP solutions weh fit handle real-world demands.
Di final phase focus on how to join MCP community and specialize for areas weh dey interest you pass. You go learn how to contribute to open-source MCP projects, use advanced authentication patterns, and build full database-integrated solutions.
Module 11 deserve special talk - na complete 13-lab hands-on learning path weh go teach you how to build production-ready MCP servers with PostgreSQL integration. E be like capstone project weh combine all wetin you don learn!
| Module | Topic | Description | Link |
|---|---|---|---|
| Module 0-3: Fundamentals | |||
| 00 | Introduction to MCP | Overview of the Model Context Protocol and its significance in AI pipelines | Read more |
| 01 | Core Concepts Explained | In-depth exploration of 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 a basic MCP client | Guide |
| 3.3 | Client with LLM | Integrate large language models | Guide |
| 3.4 | VS Code Integration | Consume MCP servers in VS Code | Guide |
| 3.5 | stdio Server | Create servers using stdio transport | Guide |
| 3.6 | HTTP Streaming | Implement HTTP streaming in MCP | Guide |
| 3.7 | AI Toolkit | Use AI Toolkit with MCP | Guide |
| 3.8 | Testing | Test your MCP server implementation | Guide |
| 3.9 | Deployment | Deploy MCP servers to production | Guide |
| 3.10 | Advanced server usage | Use advanced servers for advanced feature usage and improved architecture | Guide |
| 3.11 | Simple auth | A chapter showing you auth from the 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 the Inspector tool | Guide |
| 3.14 | Sampling | Use sampling to collaborate with the 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 large 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 Integration with Azure | Guide |
| 5.2 | Multi-modality | Working with multiple 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 in MCP | Guide |
| 5.7 | Scaling | Scale MCP implementations | Guide |
| 5.8 | Security | Advanced security considerations | Guide |
| 5.9 | Web Search | Implement web search capabilities | Guide |
| 5.10 | Realtime Streaming | Build realtime streaming functionality | Guide |
| 5.11 | Realtime Search | Implement realtime search | Guide |
| 5.12 | Entra ID Auth | Authentication with Microsoft Entra ID | Guide |
| 5.13 | Foundry Integration | Integrate with Azure AI Foundry | Guide |
| 5.14 | Context Engineering | Techniques for effective context engineering | Guide |
| 5.15 | MCP Custom Transport | Custom Transport implementations | Guide |
| 5.16 | Protocol Features | Progress notifications, cancellation, resource templates | Guide |
| Module 6-10: Community & Best Practices | |||
| 06 | Community Contributions | How to contribute to the 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 | Building an MCP Server with AI Toolkit | Lab |
| Module 11: MCP Server Hands On Lab | |||
| 11 | MCP Server Database Integration | Comprehensive 13-lab hands-on learning path for PostgreSQL integration | Labs |
| 11.1 | Introduction | Overview of MCP with database integration and retail analytics use case | Lab 00 |
| 11.2 | Core Architecture | Understanding MCP server architecture, database layers, and security patterns | Lab 01 |
| 11.3 | Security & Multi-Tenancy | Row Level Security, authentication, and multi-tenant data access | Lab 02 |
| 11.4 | Environment Setup | Setting up development environment, Docker, Azure resources | Lab 03 |
| 11.5 | Database Design | PostgreSQL setup, retail schema design, and sample data | Lab 04 |
| 11.6 | MCP Server Implementation | Building the FastMCP server with database integration | Lab 05 |
| 11.7 | Tool Development | Creating database query tools and schema introspection | Lab 06 |
| 11.8 | Semantic Search | Implementing vector embeddings with Azure OpenAI and pgvector | Lab 07 |
| 11.9 | Testing & Debugging | Testing strategies, debugging tools, and validation approaches | Lab 08 |
| 11.10 | VS Code Integration | Configuring VS Code MCP integration and AI Chat usage | Lab 09 |
| 11.11 | Deployment Strategies | Docker deployment, Azure Container Apps, and scaling considerations | Lab 10 |
| 11.12 | Monitoring | Application Insights, logging, performance monitoring | Lab 11 |
| 11.13 | Best Practices | Performance optimization, security hardening, and production tips | Lab 12 |
One of di most exciting parts of learning MCP na as your code skills go dey develop step by step. We design our code examples to start simple and grow sophisticated as your understanding deepen. Dis na how we introduce concepts - with code weh easy to understand but show real MCP principles, you go understand not just wetin di code dey do, but why e structured like dat and how e fit inside bigger MCP applications.
| 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 |
| 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 |
To get di most outta dis curriculum, yu suppose get:
-
Basic sabi for programming for at least one of di following languages: C#, Java, JavaScript, Python, or TypeScript
-
Understanding of client-server model and APIs
-
Familiarity wit REST and HTTP concepts
-
(Optional) Background for AI/ML concepts
-
Join our community discussions for support
Dis repository get plenty resources wey go help yu navigate and learn well well:
One full Study Guide dey wey go help yu navigate dis repository gidigba. Dis visual curriculum map dey show how all di topics join togeder and e go guide yu how to use di sample projects well. E good well if yu be visual learner wey like see di whole picture.
Di guide get:
- One visual curriculum map wey show all di topics wey dem cover
- Detail breakdown of each repository section
- Guidance on how to use di sample projects
- Recommended learning paths for different skill levels
- Additional resources to add on your learning waka
We dey maintain detailed Changelog wey dey track all important updates wey dem put for di curriculum materials, so yu fit dey up to date wit all di new improvements and additions.
- New content dem add
- Structural changes
- Feature beta
- Documentation updates
Every lesson for dis guide get:
- Clear explanation of MCP concepts
- Live code examples for different languages
- Exercises to build real MCP applications
- Extra resources for advanced learners
Make we learn about di Model Context Protocol (MCP), one sharp framework wey dem design to standardize how AI models and client applications go take interact. Through dis beginner-friendly session, we go introduce yu to MCP and guide yu how to create your first MCP server.
JavaScript: https://aka.ms/letslearnmcp-javascript
Congrats! Yu just take di first step for one better journey wey go expand your programming skills and connect yu to di sharp edge of AI development.
By reading dis introduction, yu don already start to build your MCP knowledge base. Yu sabi wetin MCP be, why e important, and how dis curriculum go support your learning waka. Dis na one big achievement and di start of your expertise for dis important technology.
As yu dey go through di modules, no forget say every expert once be beginner. Di concepts wey fit hard now, dey go become easy as yu dey practice and dey apply dem. Small small step na im dey build powerful skills wey go help you for your development career.
You dey join one community of learners and experts wey dey passionate about MCP and wan help others succeed. Whether yu jam coding challenge or yu dey excited to talk about breakthrough, di community dey here to support your waka.
If yu jam or get any question about building AI apps, join other learners and developers for discussions about MCP. Na one supportive community wey questions dey welcome and knowledge dey freely shared.
If yu get product feedback or errors when you dey build, make you visit:
Your MCP journey just dey start now! Begin wit Module 0 to dive inside your first hands-on MCP experience, or check out di sample projects to see wetin you go dey build. Make you remember - every expert start for wetin you dey do now, and wit patience and practice, you go surprise yourself as you fit achieve plenty.
Welcome to di world of Model Context Protocol development. Make we build something wey go shine together!
Dis curriculum dey grow strong as more learners like you dey contribute! Whether you dey fix small typo, suggest clearer explanation, or add new example, your contributions dey help other beginners succeed.
Thanks to Microsoft Valued Professional Shivam Goyal for contributing code samples.
Di contribution process dey designed to dey welcoming and supportive. Most contributions go need Contributor License Agreement (CLA), but di automated tools go guide yu through smoothly.
Dis whole curriculum dey available under di MIT LICENSE, meaning yu fit use, modify, and share am freely. Dis na to support our mission to make MCP knowledge accessible to developers everywhere.
Dis project welcome contributions and suggestions. Most contributions go need make you agree to one Contributor License Agreement (CLA) wey talk say you get di right, and you really grant 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 do CLA and go mark di PR correct (like status check or comment). Just follow wetin di bot talk. You go only need to do dis once for all repos wey dey use our CLA.
Dis project don adopt di Microsoft Open Source Code of Conduct. For more info, check di Code of Conduct FAQ or contact opencode@microsoft.com if you get any other questions or comments.
Ready to start your MCP journey? Begin wit Module 00 - Introduction to MCP and take your first step inside di world of Model Context Protocol development!
Our team dey produce other courses! Check am out:
-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}
Disclaimer:
Dis document don translate wit AI translation service Co-op Translator. Even tho we dey try make am correct, abeg make you sabi say automated translations fit get some errors or wahala. Di original document wey dem write for dia original language na di correct source. For important tins, e good make professional pipo do the human translation. We no dey responsible if any misunderstanding or wrong meaning show because of dis translation.