Skip to content

Latest commit

 

History

History
257 lines (186 loc) · 17.2 KB

File metadata and controls

257 lines (186 loc) · 17.2 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

按照以下步骤开始使用这些资源:

  1. Fork 仓库:点击 GitHub forks
  2. 克隆仓库git clone https://github.com/microsoft/mcp-for-beginners.git
  3. 加入 Azure AI Foundry Discord,结识专家和开发者

🌐 多语言支持

通过 GitHub Action 支持(自动且始终保持最新)

法语 | 西班牙语 | 德语 | 俄语 | 阿拉伯语 | 波斯语 (Farsi) | 乌尔都语 | 中文(简体) | 中文(繁体,澳门) | 中文(繁体,香港) | 中文(繁体,台湾) | 日语 | 韩语 | 印地语 | 孟加拉语 | 马拉地语 | 尼泊尔语 | 旁遮普语 (Gurmukhi) | 葡萄牙语(葡萄牙) | 葡萄牙语(巴西) | 意大利语 | 波兰语 | 土耳其语 | 希腊语 | 泰语 | 瑞典语 | 丹麦语 | 挪威语 | 芬兰语 | 荷兰语 | 希伯来语 | 越南语 | 印尼语 | 马来语 | 他加禄语(菲律宾语) | 斯瓦希里语 | 匈牙利语 | 捷克语 | 斯洛伐克语 | 罗马尼亚语 | 保加利亚语 | 塞尔维亚语(西里尔字母) | 克罗地亚语 | 斯洛文尼亚语 | 乌克兰语 | 缅甸语 (Myanmar)

🚀 面向初学者的 Model Context Protocol (MCP) 课程

通过 C#、Java、JavaScript、Python 和 TypeScript 的实战代码学习 MCP

🧠 Model Context Protocol 课程概览

Model Context Protocol (MCP) 是一个前沿框架,旨在规范 AI 模型与客户端应用之间的交互。这个开源课程提供了结构化的学习路径,包含实用的代码示例和真实案例,涵盖 C#、Java、JavaScript、TypeScript 和 Python 等主流编程语言。

无论你是 AI 开发者、系统架构师还是软件工程师,本指南都是你掌握 MCP 基础和实现策略的全面资源。

🔗 官方 MCP 资源

加入我们,参加 2025 年 7 月 29-30 日的 MCP 开发者日

准备好参加为期两天的深度技术分享、社区交流和实战学习吧!MCP 开发者日是一个专注于 Model Context Protocol(MCP)的线上活动,致力于推动 AI 模型与其依赖工具之间的标准化连接。

➡️ 注册 MCP 开发者日

你可以通过我们的活动页面 https://aka.ms/mcpdevdays 注册观看 MCP 开发者日直播。届时可通过 YouTube 或 Twitch 观看直播。所有内容都会录制并在微软开发者 YouTube 频道上发布。演示的源码也会在 GitHub 上提供。

活动详情

  • 日期:7 月 29 日(第一天)和 7 月 30 日(第二天)
  • 时间:每天上午 9:00(太平洋时间)
  • 地点:线上,随时随地参与!

第一天:MCP 生产力、开发工具与社区

专注于帮助开发者将 MCP 融入开发流程,并庆祝活跃的 MCP 社区。届时将有社区成员和合作伙伴如 Arcade、Block、Okta 和 Neon 参与,展示他们如何与微软合作,共同打造开放且可扩展的 MCP 生态系统。内容涵盖 VS Code、Visual Studio、GitHub Copilot 及热门社区工具的真实演示,实用且以上下文为驱动的开发流程,以及社区主导的分享和见解。

无论你是刚接触 MCP 还是已经在使用,第一天都会为你带来灵感和可操作的收获。

第二天:自信构建 MCP 服务器

专为 MCP 构建者设计。深入探讨 MCP 服务器的实现策略和最佳实践,以及如何将 MCP 集成到 AI 工作流中。

主题包括:

  • 构建 MCP 服务器并集成到代理体验中
  • 基于提示的开发
  • 安全最佳实践
  • 使用 Functions、ACA 和 API 管理等构建模块
  • 注册表对齐和工具支持(第一方 + 第三方)

如果你是开发者、工具构建者或 AI 产品策略师,这一天将为你提供构建可扩展、安全且面向未来的 MCP 解决方案所需的洞见。

🧭 MCP 课程概览

📚 完整课程结构

模块 主题 描述 链接
模块 1-3:基础知识
00 MCP 介绍 Model Context Protocol 概述及其在 AI 流水线中的重要性 阅读更多
01 核心概念解析 深入讲解 MCP 核心概念 阅读更多
02 MCP 安全 安全威胁与最佳实践 阅读更多
03 MCP 入门 环境搭建、基础服务器/客户端、集成 阅读更多
模块 3:构建你的第一个服务器和客户端
3.1 第一个服务器 创建你的第一个 MCP 服务器 指南
3.2 第一个客户端 开发基础 MCP 客户端 指南
3.3 带 LLM 的客户端 集成大型语言模型 指南
3.4 VS Code 集成 在 VS Code 中使用 MCP 服务器 指南
3.5 SSE 服务器 使用服务器发送事件创建服务器 指南
3.6 HTTP 流式传输 实现 MCP 中的 HTTP 流式传输 指南
3.7 AI 工具包 使用 AI 工具包配合 MCP 指南
3.8 测试 测试你的 MCP 服务器实现 指南
3.9 部署 将 MCP 服务器部署到生产环境 指南
模块 4-5:实用与高级
04 实用实现 SDK、调试、测试、可复用提示模板 阅读更多
05 MCP 高级主题 多模态 AI、扩展性、企业应用 阅读更多
5.1 Azure 集成 MCP 与 Azure 集成 指南
5.2 多模态 多模态处理 指南
5.3 OAuth2 演示 实现 OAuth2 认证 指南
5.4 根上下文 理解并实现根上下文 指南
5.5 路由 MCP 路由策略 指南
5.6 采样 MCP 中的采样技术 指南
5.7 扩展 MCP 实现的扩展方法 指南
5.8 安全 高级安全考量 指南
5.9 网络搜索 实现网络搜索功能 指南
5.10 实时流 构建实时流功能 指南
5.11 实时搜索 实现实时搜索 指南
5.12 Entra ID 认证 使用 Microsoft Entra ID 进行身份验证 指南
5.13 Foundry 集成 与 Azure AI Foundry 集成 指南
5.14 上下文工程 有效上下文工程的技术 指南
模块 6-10:社区与最佳实践
06 社区贡献 如何为 MCP 生态系统做出贡献 指南
07 早期采用的见解 真实世界的实施案例 指南
08 MCP 最佳实践 性能、容错性、弹性 指南
09 MCP 案例研究 实际实施示例 指南
10 实操工作坊 使用 AI 工具包构建 MCP 服务器 实验

💻 示例代码项目

基础 MCP 计算器示例

语言 描述 链接
C# MCP 服务器示例 查看代码
Java MCP 计算器 查看代码
JavaScript MCP 演示 查看代码
Python MCP 服务器 查看代码
TypeScript MCP 示例 查看代码

高级 MCP 实现

语言 描述 链接
C# 高级示例 查看代码
Java 容器应用示例 查看代码
JavaScript 高级示例 查看代码
Python 复杂实现 查看代码
TypeScript 容器示例 查看代码

🎯 学习 MCP 的先决条件

为了最大化本课程的学习效果,你应具备:

  • 至少掌握以下语言之一的基础编程知识:C#、Java、JavaScript、Python 或 TypeScript

  • 理解客户端-服务器模型和 API

  • 熟悉 REST 和 HTTP 概念

  • (可选)具备 AI/ML 相关背景知识

  • 加入我们的社区讨论以获取支持

📚 学习指南与资源

本仓库包含多种资源,帮助你高效学习和导航:

学习指南

提供一份全面的学习指南,帮助你有效浏览本仓库。指南内容包括:

  • 课程主题的可视化地图
  • 各部分内容的详细拆解
  • 如何使用示例项目的指导
  • 针对不同技能水平的推荐学习路径
  • 补充学习资源

更新日志

我们维护一份详细的更新日志,记录课程材料的所有重要更新,包括:

  • 新增内容
  • 结构调整
  • 功能改进
  • 文档更新

🛠️ 如何高效使用本课程

本指南中的每节课均包含:

  1. 清晰的 MCP 概念讲解
  2. 多语言的实时代码示例
  3. 构建真实 MCP 应用的练习
  4. 面向高级学习者的额外资源

🌟 社区感谢

感谢 Microsoft 资深专家 Shivam Goyal 贡献了重要的代码示例。

📜 许可信息

本内容采用 MIT 许可证 许可。条款详情请参见 LICENSE

🤝 贡献指南

本项目欢迎贡献和建议。大多数贡献需要你同意一份贡献者许可协议(CLA),声明你有权且确实授予我们使用你贡献的权利。详情请访问
https://cla.opensource.microsoft.com

当你提交拉取请求时,CLA 机器人会自动判断你是否需要提供 CLA,并相应地标注 PR(如状态检查、评论)。只需按照机器人指示操作即可。你只需在所有使用我们 CLA 的仓库中完成一次。

本项目采用了 Microsoft 开源行为准则
更多信息请参见 行为准则常见问题 或联系 opencode@microsoft.com 以获取额外问题或反馈。

📂 仓库结构

仓库结构如下:

  • 核心课程 (00-10):主内容,分为十个顺序模块
  • images/:课程中使用的图表和插图
  • translations/:多语言支持及自动翻译
  • translated_images/:本地化的图表和插图
  • study_guide.md:全面的仓库导航指南
  • changelog.md:课程材料的重要变更记录
  • mcp.json:MCP 规范配置文件
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md:项目治理文档

🎒 其他课程

我们团队还制作了其他课程!欢迎查看:

™️ 商标声明

本项目可能包含项目、产品或服务的商标或标识。微软商标或标识的授权使用须遵守并符合
微软商标与品牌指南
在本项目的修改版本中使用微软商标或标识不得引起混淆或暗示微软赞助。
任何第三方商标或标识的使用均须遵守相应第三方的政策。

免责声明
本文件使用 AI 翻译服务 Co-op Translator 进行翻译。虽然我们力求准确,但请注意,自动翻译可能包含错误或不准确之处。原始文件的母语版本应被视为权威来源。对于重要信息,建议采用专业人工翻译。对于因使用本翻译而产生的任何误解或误释,我们不承担任何责任。