教程文档人工智能【免费下载链接】mcp-for-beginnersThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable, and secure AI workflows from session setup to service orchestration.项目地址https://gitcode.com/GitHub_Trending/mc/mcp-for-beginners点击查看免费下载本指南面向 AI 开发者、系统架构师与软件工程师系统梳理mcp-for-beginners开源课程仓库的整体结构、学习路径与资源分布。读完后你将掌握如何按章节顺序从 MCP 协议基础一路进阶到生产级服务器开发理解每章对应的文档位置、示例代码与配套工具并能依据自身编程语言偏好C#/.NET、Java、JavaScript、TypeScript、Python、Rust快速定位可运行的实操样本。仓库概览一个覆盖全生命周期的 MCP 课程体系Model Context ProtocolMCP模型上下文协议是用于 AI 模型与客户端应用之间交互的标准化框架。该协议最初由 Anthropic 创建现由更广泛的 MCP 社区通过官方 GitHub 组织维护。本仓库在此基础上构建了一套完整的开源课程从协议概念、安全最佳实践、入门实操首个服务器、客户端、LLM 客户端、传输方式、测试与部署到多语言 SDK 的工程实现、高级主题、企业案例研究以及两套动手实验室AI Toolkit 工作坊与 PostgreSQL 数据库集成路径覆盖了从会话建立到服务编排的完整技术栈。课程的代码示例覆盖C#、Java、JavaScript、Python、TypeScript五种主流语言仓库03-GettingStarted/samples/下还提供了 Rust 示例每一章均配有独立的 README、练习与示例项目便于按需导航与实操。课程可视化地图下图以思维导图形式浓缩了整套课程的十二大模块及其子主题可作为快速定位章节的导航索引仓库结构十二大模块逐一详解仓库分为十二个主要章节外加工具章节每个章节聚焦 MCP 的不同侧面。下面结合各章节文档与仓库源码逐一展开说明其内容与入口。1. 绪论00-Introduction/MCP 协议概览为什么在 AI 流水线中标准化至关重要实际用例与收益章节文档 00-Introduction/README.md 指出生成式 AI 应用初期很容易上手但随着应用成长需要定义架构并依赖标准来保证构建方式的一致性MCP 正是为此提供标准的组织方式。标准化带来的收益包括互操作性LLM 与不同厂商工具无缝协作、一致性跨平台与工具的统一行为、可重用性一次构建的工具可跨项目复用与加速开发即插即用接口缩短开发时间。该章还梳理了 MCP 的两层协议架构数据层基于 JSON-RPC 2.0 的消息、按请求携带的元数据、能力发现与协议原语传输层本地子进程使用 stdio远程服务器使用 Streamable HTTP流式响应可选用 SSE 帧但旧的 HTTPSSE 传输已被弃用。2. 核心概念01-CoreConcepts/客户端-服务器架构关键协议组件MCP 中的消息模式当前规范MCP 2026-07-28 规范变更详解 —— 无状态协议核心、Extensions 框架以及 Roots/Sampling/Logging 的弃用01-CoreConcepts/README.md 深入讲解了 MCP 生态的三大角色MCP Hosts运行 AI 模型并与用户交互的应用如 Visual Studio Code、Claude Desktop、IDE 与 AI 工具负责编排模型、管理客户端关系、控制用户界面、执行安全策略与用户授权MCP ClientsHost 内为每个 MCP 服务器创建的一对一协议连接组件负责发送 JSON-RPC 2.0 请求、通过server/discover做能力发现、执行工具调用并处理实时通知MCP Servers暴露特定能力工具、资源、提示词的轻量级程序支持本地与远程两种部署形态。服务器侧三大原语Resources资源为模型提供上下文的数据源通过 URI 标识支持resources/list发现与resources/read读取例如file://documents/project-spec.md、database://production/users/schemaPrompts提示词可复用的交互模板支持变量替换通过prompts/list与prompts/get使用Tools工具模型可调用的可执行函数用 JSON Schema 定义参数校验通过tools/list发现、tools/call执行并支持readOnlyHint、destructiveHint等行为注解帮助客户端判断工具是只读还是破坏性的。客户端侧原语Sampling服务器请求客户端 LLM 补全2026-07-28已弃用、Roots客户端向服务器标识相关文件系统位置已弃用、Elicitation服务器在处理请求期间请求用户输入/确认通过elicitation/create实现。版本演进提示MCP 采用基于日期的版本命名YYYY-MM-DD。当前协议版本为2026-07-28。该版本在传输层移除了initialize握手与协议级会话 ID使协议变为无状态同时正式确立了 Extensions 扩展框架并弃用 Roots、Sampling、Logging。显式针对2025-11-25的示例作为遗留兼容课程保留。3. 安全02-Security/MCP 系统中的安全威胁安全实现的最佳实践认证与授权策略可运行的 CIMD 与 DCR 授权示例完整安全文档MCP 安全最佳实践、Azure Content Safety 实现指南、MCP 安全控制与技术、MCP 最佳实践速查关键安全主题提示注入与工具投毒攻击、会话劫持与混淆代理问题、令牌透传漏洞、过度权限与访问控制、AI 组件的供应链安全、Microsoft Prompt Shields 集成02-Security/README.md 是课程中最重的安全章节其核心内容值得单独强调间接提示注入Indirect Prompt Injection攻击者将恶意指令嵌入外部内容文档、网页、邮件、数据源AI 系统会将其当作合法命令处理可能造成数据外泄、隐私泄露与越权操作工具投毒Tool Poisoning攻击者篡改工具描述、参数定义与使用示例等元数据甚至通过动态修改工具rug pulls把用户已批准的工具悄悄替换成恶意行为——托管在远程的 MCP 服务器风险尤高会话劫持窃取会话 ID 冒充客户端执行未授权操作因此服务器必须验证所有入站请求绝不能依赖会话完成认证混淆代理问题Confused DeputyMCP 服务器作为客户端与第三方服务之间的认证代理时可通过静态客户端 ID 利用既有 consent cookie 绕过授权需以显式用户同意、OAuth 2.1 PKCE 与严格的重定向 URI 校验来缓解令牌透传Token Passthrough是被规范明令禁止的反模式——服务器不得接受并非显式为其签发的令牌并转发给下游 API否则会绕过限流、校验与监控控制破坏审计链并制造数据外泄通道。章节还给出了OWASP MCP Top 10风险对照表MCP01 令牌管理与机密泄露、MCP02 权限蔓延导致提权、MCP03 工具投毒、MCP04 供应链攻击、MCP05 命令注入、MCP06 意图流颠覆、MCP07 认证授权不足、MCP08 审计与遥测缺失、MCP09 影子 MCP 服务器、MCP10 上下文注入与过度共享并推荐通过MCP Security Summit WorkshopSherpa进行从 Base Camp 到 Summit 的分阶段动手安全演练。4. 入门03-GettingStarted/环境搭建与配置创建基础 MCP 服务器与客户端与现有应用集成包含以下课程小节课程主题1. 第一个服务器创建第一个服务器并用 MCP Inspector 检查、测试、调试2. 客户端编写可连接服务器的客户端3. 带 LLM 的客户端让客户端内嵌 LLM与服务器协商如何行动4. VS Code 集成在 Visual Studio Code 中运行 MCP 服务器Copilot Agent 模式5. stdio 传输服务器本地 MCP 通信推荐标准基于子进程隔离6. HTTP 流式传输Streamable HTTP 远程传输标准含遗留会话式实现7. AI Toolkit使用 VS Code 的 AI Toolkit 消费与测试 MCP 客户端/服务器8. 测试以多种方式测试服务器与客户端9. 部署MCP 解决方案的不同部署方式10. 高级服务器用法高级服务器用法11. 简单认证从 Basic Auth 到 JWT 与 RBAC随后进阶第 5 章高级主题12. MCP Hosts配置 Claude Desktop、Cursor、Cline、Windsurf 等主流宿主13. MCP Inspector交互式调试与测试工具、资源与协议消息14. Sampling遗留2025-11-25Sampling 原语及其迁移方案2026-07-28已弃用15. MCP Apps构建既返回数据又返回 UI 指令的 MCP 服务器环境准备按所选语言准备开发环境C#、Java、Python、TypeScript 或 JavaScript、IDEVisual Studio、VS Code、IntelliJ、Eclipse、PyCharm 等、包管理器NuGet、Maven/Gradle、pip、npm/yarn以及连接 AI 服务所需的 API 密钥。官方 SDK各语言对2026-07-28的支持独立推进运行示例前请核对包版本与 SDK 发布说明C# SDK与微软合作维护、Java SDK与 Spring AI 合作维护、TypeScript SDK、Python SDKFastMCP、Kotlin SDK、Swift SDK、Rust SDK、Go SDK。配套示例项目本仓库在 samples 目录 下提供了 Java 计算器、.NET 计算器、JavaScript 计算器、TypeScript 计算器、Python 计算器 与 Rust 示例与各章练习互为补充。5. 实践实现04-PracticalImplementation/在不同编程语言中使用 SDK调试、测试与验证技术构建可复用的提示词模板与工作流含实现示例的示例项目04-PracticalImplementation/README.md 强调理论之外的真正价值在于把概念落地为可构建、可测试、可部署的解决方案并提供了多语言 SDK 样本C#、Java with Spring、TypeScript、JavaScript、Python注意Java with Spring SDK 依赖 Project Reactor分页与大数据集针对工具、资源与大结果集处理基于游标的分页API 管理与云端部署将 Azure API Management 实例置于 MCP 服务器之前由其统一处理限流、令牌管理、监控、负载均衡与安全并通过azd up将远程 MCP 服务器部署到 Azure以az provider register --namespace Microsoft.App --wait注册资源提供方为前提再用npx modelcontextprotocol/inspector启动 MCP Inspector 进行端到端工具调用测试。6. 高级主题05-AdvancedTopics/上下文工程技术Foundry 智能体集成多模态 AI 工作流OAuth2 认证演示实时搜索能力实时流式传输Root 上下文实现2026-07-28已弃用路由策略采样技术2026-07-28已弃用扩展方法安全考量Entra ID 安全集成Web 搜索集成对抗性多智能体推理辩论模式05-AdvancedTopics/README.md 以表格形式列出了 17 个进阶课程模块仓库中均有对应子目录与 README例如 MCP OAuth2 演示同时作为授权服务器与资源服务器的 Spring Boot 应用、Web 搜索 MCPPython 服务器与客户端集成 SerpAPI 实现实时网页/新闻/商品搜索与问答、Entra ID 认证、Foundry 智能体集成含 Python 与 .NET 笔记本示例、协议特性深入进度通知、请求取消、资源模板与错误处理模式以及 对抗性多智能体推理两个持对立立场的智能体共享一套工具集通过结构化辩论捕捉幻觉与边界情况。7. 社区贡献06-CommunityContributions/如何贡献代码与文档通过 GitHub 协作社区驱动的增强与反馈使用各种 MCP 客户端Claude Desktop、Cline、VSCode使用流行的 MCP 服务器包括图像生成06-CommunityContributions/README.md 介绍了加入 MCP 生态的贡献路径通过 GitHub 讨论与 Discord 频道连接专家与开发者向课程仓库提交代码与文档改进并了解主流客户端与图像生成类服务器如 Azure OpenAI DALL-E 3、Stable Diffusion WebUI、Replicate的集成方式。8. 早期采用者的经验07-LessonsfromEarlyAdoption/真实世界的实现与成功故事构建与部署基于 MCP 的解决方案趋势与未来路线图Microsoft MCP 服务器指南涵盖十个生产就绪的 Microsoft MCP 服务器07-LessonsfromEarlyAdoption/README.md 汇总了早期采用者的实践案例企业客服自动化、医疗诊断助手、金融服务风险分析、Playwright 浏览器自动化、Azure MCP 托管服务、NLWeb、Microsoft Foundry MCP 服务器、Foundry MCP Playground、Microsoft Learn Docs MCP 服务器等并给出了后续可动手实践的项目设想多提供商 MCP 服务器、企业提示词管理系统、基于 MCP 的内容生成平台。Microsoft MCP 服务器指南07-LessonsfromEarlyAdoption/microsoft-mcp-servers.md收录的十个服务器为Microsoft Learn Docs MCP ServerAzure MCP Server15 个专业化连接器GitHub MCP ServerAzure DevOps MCP ServerMarkItDown MCP ServerSQL Server MCP ServerPlaywright MCP ServerDev Box MCP ServerMicrosoft Foundry MCP ServerMicrosoft 365 Agents Toolkit MCP Server9. 最佳实践08-BestPractices/性能调优与优化设计容错的 MCP 系统测试与韧性策略08-BestPractices/README.md 从标准化通信、以用户为中心、安全优先、模块化架构、显式状态五项核心原则出发给出安全用户同意与控制、数据隐私、工具安全、工具权限控制、认证、参数校验、限流与实现能力协商、聚焦工具设计、统一错误处理、可观测性、进度追踪、请求取消两方面的最佳实践并附大量多语言代码示例单一职责工具、结构化错误响应、参数校验、认证授权、限流中间件、单元/集成测试、缓存与异步处理等。该章节还特别提供了可靠性伴生课程Safe Retries for MCP Tools: A Reliability Sidecar Pattern通用重试循环对会创建工单、支付、消息、部署等真实世界副作用的工具并不安全响应可能在效果提交后丢失应改用稳定操作键、重复受理、检查点、对账、证据等级与故障注入等模式。10. 案例研究09-CaseStudy/七个综合案例研究展示 MCP 在不同场景下的通用性案例说明Azure AI Travel Agents基于 Azure OpenAI 与 AI Search 的多智能体编排Azure DevOps 集成用 YouTube 数据自动化工作项更新流程实时文档检索使用流式 HTTP 的 Python 控制台客户端交互式学习计划生成器基于 Chainlit 的对话式 AI 网页应用编辑器内文档与 GitHub Copilot 工作流结合的 VS Code 集成Azure API Management企业 API 集成与 MCP 服务器创建GitHub MCP Registry生态发展与智能体集成平台09-CaseStudy/README.md 指出案例研究覆盖企业集成、开发者生产力与生态发展等多个维度从复杂多智能体旅行规划与 Azure API Management到流式文档工作流与 GitHub MCP Registry。此外还包含第 8 个案例 通过智能体发布到社交网络深入讲解写能力远程 MCP 服务器的设计约束——开放发现、认证执行tools/list无需凭证即可内省每次tools/call必须携带令牌、OAuth 注册、工具注解、不可伪造的标识符、幂等键与无操作目标适合任何写入型服务器参考。11. 动手工作坊10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/将 MCP 与 AI Toolkit 结合的综合性动手工作坊构建连接 AI 模型与真实工具的智能应用覆盖基础、自定义服务器开发与生产部署策略的实战模块实验室结构实验室 1MCP 服务器基础实验室 2高级 MCP 服务器开发实验室 3AI Toolkit 集成实验室 4生产部署与扩展基于实验室的逐步学习方式工作坊 README 建议的系统要求为Windows 10/macOS 10.15/Linux、最新稳定版 VS Code、Node.js v18.0 与 npm、Python 3.10可选、最低 8GB 内存本地模型建议 16GB。四个实验室的时间规划为 15–30 分钟从 Microsoft Foundry Toolkit 与模型目录起步到浏览器自动化智能体Playwright MCP再到自建 Weather/GitHub Clone MCP 服务器并与 Copilot Agent Mode 结合。需注意该工作坊代码基于 MCP2025-11-25构建与测试仓库 README 顶部有徽章标注新实现请以当前2026-07-28规范为准。12. MCP 服务器数据库集成实验室11-MCPServerHandsOnLabs/构建集成 PostgreSQL 的生产就绪 MCP 服务器的13 个实验室完整学习路径使用Zava Retail用例的真实零售分析实现包含Row Level SecurityRLS、语义搜索与多租户数据访问的企业级模式完整实验室结构实验室 00-03基础—— 简介、架构、安全、环境搭建实验室 04-06构建 MCP 服务器—— 数据库设计、MCP 服务器实现、工具开发实验室 07-09高级特性—— 语义搜索、测试与调试、VS Code 集成实验室 10-12生产与最佳实践—— 部署、监控、优化覆盖技术FastMCP 框架、PostgreSQL、Azure OpenAI、Azure Container Apps、Application Insights学习成果生产就绪的 MCP 服务器、数据库集成模式、AI 驱动的分析、企业级安全11-MCPServerHandsOnLabs/README.md 为不同经验水平的读者提供了三条推荐路径入门路径先完成本课程 0–10 章再做 00–06 号实验室夯实基础进阶 07–09 实践、中级路径聚焦 02–06 实现深入 07–12 高级特性、高级路径略读 00–03聚焦 04–09 数据库集成重点攻克 10–12 生产部署。所需工具包括 Docker Desktop、Azure CLI、VS Code、Git 与 Python 3.8。13. 工具12-tooling/学习如何在 Copilot 应用与其他工具中使用 MCP12-tooling/README.md 及其子章节 01-copilot-app 展示了在微软 Copilot 应用生态中配置与使用 MCP 服务器的实际操作。附加资源仓库还提供了两类支撑资源images 目录包含课程全程使用的架构图、流程示意图与视频缩略图例如安全章节的 prompt-injection.png间接提示注入攻击示意与 tool-injection.png工具投毒攻击示意translations 目录通过自动化翻译提供 60 语言版本的文档如本文对应英文原版 study_guide.md便于非英语开发者按母语学习官方 MCP 资源官方 MCP 文档、MCP2026-07-28规范与 MCP GitHub 组织仓库可在仓库各章节 README 的Additional Resources中找到对应入口。如何高效使用本仓库顺序学习按章节顺序00 至 11逐一推进获得结构化的完整学习体验语言专项若对特定编程语言感兴趣进入 samples 示例目录按语言挑选实现C#、Java、JavaScript、TypeScript、Python、Rust实践优先从 入门章节 开始搭建环境并创建第一个 MCP 服务器与客户端用 MCP Inspector 完成交互式调试进阶探索掌握基础后深入 高级主题 扩展知识边界社区参与通过 GitHub 讨论与 Discord 频道加入 MCP 社区与专家和其他开发者建立联系。MCP 客户端与工具课程覆盖多种 MCP 客户端与工具官方客户端Visual Studio Code含 VS Code 内的 MCP 支持Claude DesktopClaude in VSCodeClaude API社区客户端Cline终端型Cursor代码编辑器ChatMCPWindsurfMCP 管理工具MCP CLIMCP ManagerMCP LinkerMCP Router热门 MCP 服务器仓库还介绍了丰富的 MCP 服务器生态官方 Microsoft MCP 服务器Microsoft Learn Docs、Azure15 连接器、GitHub、Azure DevOps、MarkItDown、SQL Server、Playwright、Dev Box、Microsoft Foundry、Microsoft 365 Agents Toolkit详见 Microsoft MCP 服务器指南。官方参考服务器Filesystem、Fetch、Memory、Sequential Thinking。图像生成Azure OpenAI DALL-E 3、Stable Diffusion WebUI、Replicate。开发工具Git MCP、终端控制、代码助手。专业化服务器Salesforce、Microsoft Teams、Jira Confluence。贡献本仓库欢迎社区贡献。请参阅 社区贡献章节 了解如何有效参与 MCP 生态建设——包括代码与文档提交、GitHub 协作流程以及基于主流客户端Claude Desktop、Cline、VSCode与图像生成服务器的集成实践。版本说明与课程现状本学习指南最后更新于2026 年 9 月 9 日反映 MCP 规范2026-07-28当前协议修订版。部分动手示例仍显式版本化为2025-11-25这是因为相关 SDK 与工具尚在向无状态协议 API 迁移的过程中阅读这些示例时请将其视为遗留兼容性指导新实现应优先采用2026-07-28的无状态请求模型、Extensions 框架与替代模式工具参数/资源 URI/服务器配置替代 Roots直接集成 LLM 提供商 API 替代 Samplingstderr与 OpenTelemetry 替代 Logging。赞分享教程文档人工智能【免费下载链接】mcp-for-beginnersThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable, and secure AI workflows from session setup to service orchestration.项目地址https://gitcode.com/GitHub_Trending/mc/mcp-for-beginners点击查看免费下载相关推荐mcp-for-beginners 学习指南MCP 课程体系、仓库导航与实践路线图mcp for beginners 学习指南MCP 课程体系、仓库导航与实践路线图 本指南面向希望系统学习 Model Context ProtocolMC教程文档人工智能MCP for Beginners 学习指南一站式导航 Model Context Protocol 初学者课程仓库MCP for Beginners 学习指南一站式导航 Model Context Protocol 初学者课程仓库 导读 本文是开源课程仓库「Model C教程文档人工智能AI for Beginners 课程学习地图Mindmap 全解析与 24 课导航指南AI for Beginners 课程学习地图Mindmap 全解析与 24 课导航指南 本指南以课程官方 Mindmap思维导图为骨架为读者系统梳理教程人工智能机器学习深度学习上一篇解决90% Kong故障的实战指南从启动失败到性能优化下一篇从混沌到有序Dubbo三大负载均衡算法如何解决微服务流量分配难题创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考