microsoft/mcp-for-beginners

git clone https://github.com/microsoft/mcp-for-beginners.git
Sparse checkout to skip the 50+ language translations: `git clone --filter=blob:none --sparse <repo> && git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'`

Usage

• •Start with Module 00 (Introduction) and work through Module 01 Core Concepts, Module 02 Security, and Module 03 Getting Started
• •Follow the hands-on guides 3.1-3.15: first server, first client, LLM client, VS Code integration, stdio server, HTTP streaming, testing, deployment, auth, MCP hosts (Claude Desktop/Cursor/Cline), MCP Inspector, sampling, MCP Apps
• •Aligned with MCP Specification 2025-11-25; read the 2026-07-28 release candidate notes for the upcoming stateless protocol / Extensions framework
• •Practice with the sample code projects in each language or follow the video tutorial series (aka.ms/letslearnmcp-*)

Key features

• ✓12 modules: fundamentals, security, building servers/clients, practical implementation, advanced topics (Azure, multi-modality, OAuth2, routing, scaling), community/best practices, case studies
• ✓Sample code in C#, Java, JavaScript, Python, TypeScript, Rust
• ✓Module 11: 13-lab hands-on path building a production-ready MCP server with PostgreSQL integration
• ✓Translated into 50+ languages via automated GitHub Action

Best for

Beginner-to-intermediate developers who want a structured, multi-language curriculum to learn how to build MCP servers and clients.

Caveats

• ⚠This is a documentation/tutorial repository, NOT a runnable MCP server
• ⚠Repo size is large due to 50+ translations — use sparse checkout to avoid the bloat