microsoft/mcp-for-beginners

它是什么

微软出品的一份免费、结构化的学习路径（"课程"），从零开始教授模型上下文协议（MCP）。README 中将 MCP 描述为"AI 应用的通用翻译器"——一套约定俗成的规则，让 AI 模型能够以标准化方式连接到任何工具或服务，类似于 USB 接口让任何设备都能插入电脑。该课程包含 C#、Java、JavaScript、Rust、Python 和 TypeScript 的动手代码示例。

你将学到什么

• 理解 MCP 基础知识（协议是什么以及为什么重要）
• 用你偏好的语言构建你的第一个 MCP 服务器
• 将 AI 模型连接到真实工具和服务
• 实施安全最佳实践
• 将 MCP 项目从开发部署到生产环境
• 加入并为 MCP 开发者社区做贡献

课程分为多个模块：基础（模块 0–2：介绍、核心概念、安全）、构建（模块 3：创建服务器和客户端，包含 VS Code 集成、HTTP 流式传输、测试、部署和调试工具等指南）、进阶（模块 4–5：高级主题，如 Azure 集成、多模态 AI、OAuth2、路由、扩展、实时流式传输）和精通（模块 6–11：社区贡献和专业化，包括一个 13 个实验的顶点项目，用于构建生产就绪的 PostgreSQL MCP 服务器）。

README 中的关键细节

• 当前教授的协议版本：MCP 规范 2026-07-28（基于日期的版本控制）。一些示例仍明确标记为旧版本（2025-11-25），等待 SDK 支持跟上。
• 仓库中包含 50 多种语言翻译，使用 Co-op Translator 工具维护。
• 由于翻译导致仓库较大，README 提供了"稀疏检出"命令，以便在不包含翻译文件夹的情况下克隆仓库，加快下载速度。
• 要开始使用，README 建议：fork 仓库、克隆它，并加入 Microsoft Foundry Discord 服务器。
• 链接的官方资源：MCP 文档站点、MCP 规范、MCP GitHub 组织（托管 SDK 和代码示例）以及 MCP 社区讨论。

目标受众

初学者。README 明确表示它"设计时充满耐心和关怀"，使用日常类比（如电话交谈规则和标准化加油泵），并强调你不需要成为基础概念的专家——这些会在学习过程中逐步解释。

值得注意的额外内容

模块 11 被重点介绍为一条完整的 13 个实验的动手路径，用于构建生产就绪的 PostgreSQL 集成 MCP 服务器，作为顶点项目，将之前学到的所有内容串联起来。