MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

按照以下步驟開始使用這些資源：

  1. 分叉此倉庫：點擊 GitHub forks
  2. 克隆倉庫： git clone https://github.com/microsoft/mcp-for-beginners.git
  3. 加入 Azure AI Foundry Discord，與專家和其他開發者交流

🌐 多語言支持

通過 GitHub Action 支持（自動化且始終保持最新）

阿拉伯語 | 孟加拉語 | 保加利亞語 | 緬甸語 | 中文（簡體） | 中文（繁體，香港） | 中文（繁體，澳門） | 中文（繁體，台灣） | 克羅地亞語 | 捷克語 | 丹麥語 | 荷蘭語 | 芬蘭語 | 法語 | 德語 | 希臘語 | 希伯來語 | 印地語 | 匈牙利語 | 印尼語 | 意大利語 | 日語 | 韓語 | 馬來語 | 馬拉地語 | 尼泊爾語 | 挪威語 | 波斯語（法爾西語） | 波蘭語 | 葡萄牙語（巴西） | 葡萄牙語（葡萄牙） | 旁遮普語（古魯穆奇文） | 羅馬尼亞語 | 俄語 | 塞爾維亞語（西里爾文） | 斯洛伐克語 | 斯洛文尼亞語 | 西班牙語 | 斯瓦希里語 | 瑞典語 | 他加祿語（菲律賓語） | 泰語 | 土耳其語 | 烏克蘭語 | 烏爾都語 | 越南語

🚀 初學者的模型上下文協議（MCP）課程

通過 C#、Java、JavaScript、Rust、Python 和 TypeScript 的實際代碼示例學習 MCP

🧠 模型上下文協議課程概述

**模型上下文協議（MCP）**是一個前沿框架，旨在標準化 AI 模型與客戶端應用之間的交互。這個開源課程提供了一個結構化的學習路徑，包含實際的編程示例和真實世界的應用案例，涵蓋 C#、Java、JavaScript、TypeScript 和 Python 等流行編程語言。

無論您是 AI 開發者、系統架構師還是軟件工程師，本指南都是掌握 MCP 基礎知識和實施策略的全面資源。

🔗 官方 MCP 資源

🧭 MCP 課程概述

📚 完整課程結構

模組主題描述連結
模組 1-3：基礎知識
00MCP 簡介MCP 的概述及其在 AI 流程中的重要性了解更多
01核心概念解析深入探討 MCP 的核心概念了解更多
02MCP 的安全性安全威脅及最佳實踐了解更多
03MCP 入門環境設置、基本服務器/客戶端、集成了解更多
模組 3：建立您的第一個服務器和客戶端
3.1第一個服務器創建您的第一個 MCP 服務器指南
3.2第一個客戶端開發一個基本的 MCP 客戶端指南
3.3帶 LLM 的客戶端集成大型語言模型指南
3.4VS Code 集成在 VS Code 中使用 MCP 服務器指南
3.5stdio 服務器使用 stdio 傳輸創建服務器指南
3.6HTTP 流式傳輸在 MCP 中實現 HTTP 流式傳輸指南
3.7AI 工具包使用 MCP 的 AI 工具包指南
3.8測試測試您的 MCP 服務器實現指南
3.9部署將 MCP 服務器部署到生產環境指南
3.10高級服務器使用使用高級服務器以實現高級功能和改進架構指南
3.11簡單身份驗證從基礎開始展示身份驗證和 RBAC指南
模組 4-5：實踐與高級主題
04實踐應用SDK、調試、測試、可重用的提示模板了解更多
05MCP 高級主題多模態 AI、擴展、企業應用了解更多
5.1Azure 集成MCP 與 Azure 的集成指南
5.2多模態處理多種模態指南
5.3OAuth2 演示實現 OAuth2 身份驗證指南
5.4根上下文理解並實現根上下文指南
5.5路由MCP 路由策略指南
5.6取樣MCP 中的取樣技術指南
5.7擴展擴展 MCP 的實現指南
5.8安全性高級安全考量指南
5.9網頁搜索實現網頁搜索功能指南
5.10實時流式傳輸構建實時流式傳輸功能指南
5.11實時搜索實現實時搜索指南
5.12Entra ID 身份驗證使用 Microsoft Entra ID 進行身份驗證指南
5.13Foundry 集成與 Azure AI Foundry 集成指南
5.14上下文工程有效上下文工程的技術指南
5.15MCP 自定義傳輸自定義傳輸的實現指南
模組 6-10：社群與最佳實踐
06社群貢獻如何為 MCP 生態系統做出貢獻指南
07早期採用的洞察真實世界的實施故事指南
08MCP 的最佳實踐性能、容錯、韌性指南
09MCP 案例研究實際應用示例指南
10實作工作坊使用 AI 工具包構建 MCP 服務器實驗
模組 11：MCP 服務器實作實驗室
11MCP 服務器數據庫集成針對 PostgreSQL 集成的全面 13 篇實驗學習路徑實驗
11.1簡介MCP 與數據庫集成及零售分析應用案例概述實驗 00
11.2核心架構了解 MCP 伺服器架構、資料庫層級及安全性模式Lab 01
11.3安全性與多租戶行級安全性、身份驗證及多租戶資料存取Lab 02
11.4環境設置設置開發環境、Docker、Azure 資源Lab 03
11.5資料庫設計PostgreSQL 設置、零售模式設計及範例資料Lab 04
11.6MCP 伺服器實作建立與資料庫整合的 FastMCP 伺服器Lab 05
11.7工具開發創建資料庫查詢工具及模式檢視Lab 06
11.8語意搜尋使用 Azure OpenAI 和 pgvector 實現向量嵌入Lab 07
11.9測試與除錯測試策略、除錯工具及驗證方法Lab 08
11.10VS Code 整合配置 VS Code MCP 整合及 AI 聊天使用Lab 09
11.11部署策略Docker 部署、Azure Container Apps 及擴展考量Lab 10
11.12監控應用洞察、日誌記錄及性能監控Lab 11
11.13最佳實踐性能優化、安全性加固及生產環境技巧Lab 12

💻 範例程式專案

基本 MCP 計算器範例

語言描述連結
C#MCP 伺服器範例查看程式碼
JavaMCP 計算器查看程式碼
JavaScriptMCP 示範查看程式碼
PythonMCP 伺服器查看程式碼
TypeScriptMCP 範例查看程式碼
RustMCP 範例查看程式碼

高級 MCP 實作

語言描述連結
C#高級範例查看程式碼
Java with Spring容器應用範例查看程式碼
JavaScript高級範例查看程式碼
Python複雜實作查看程式碼
TypeScript容器範例查看程式碼

🎯 學習 MCP 的先決條件

為了充分利用此課程內容，您應具備以下知識：

  • 至少熟悉以下任一程式語言的基本編程知識：C#、Java、JavaScript、Python 或 TypeScript

  • 了解客戶端-伺服器模型及 API

  • 熟悉 REST 和 HTTP 概念

  • （選擇性）具備 AI/ML 概念背景

  • 加入我們的社群討論以獲得支援

📚 學習指南與資源

此存儲庫包含多種資源，幫助您有效學習：

學習指南

提供一份全面的 學習指南，幫助您有效瀏覽此存儲庫。指南包括：

  • 顯示所有涵蓋主題的視覺課程地圖
  • 每個存儲庫部分的詳細分解
  • 使用範例專案的指導
  • 根據不同技能水平推薦的學習路徑
  • 補充學習旅程的額外資源

更新日誌

我們維護了一份詳細的 更新日誌，記錄課程材料的所有重要更新，包括：

  • 新內容添加
  • 結構變更
  • 功能改進
  • 文件更新

🛠️ 如何有效使用此課程

此指南中的每節課程包括：

  1. 清晰的 MCP 概念解釋
  2. 多語言的即時程式碼範例
  3. 建立真實 MCP 應用的練習
  4. 提供進階學習者的額外資源

活動

MCP 開發日 2025 年 7 月

➡️隨選觀看 - MCP 開發日

準備好參加為期兩天的深入技術洞察、社群連結及實作學習的 MCP 開發日虛擬活動，專注於模型上下文協議（MCP）——一項連接 AI 模型及其依賴工具的新興標準。 您可以透過活動頁面註冊觀看 MCP 開發日：https://aka.ms/mcpdevdays。

第一天：MCP 生產力、開發工具及社群

第一天旨在幫助開發者將 MCP 融入其開發工作流程，並慶祝 MCP 社群的卓越成就。我們將與社群成員及合作夥伴（如 Arcade、Block、Okta 和 Neon）一起探討他們如何與 Microsoft 合作，共同打造開放且可擴展的 MCP 生態系統。
實際示範 VS Code、Visual Studio、GitHub Copilot 及流行社群工具
實用的上下文驅動開發工作流程
社群主導的會議及洞察
無論您是剛開始接觸 MCP 還是已經在使用它，第一天將提供啟發性及可操作的收穫。

第二天：自信地構建 MCP 伺服器

第二天專為 MCP 建設者設計。我們將深入探討構建 MCP 伺服器及將 MCP 整合到 AI 工作流程中的實作策略及最佳實踐。

主題包括：

  • 構建 MCP 伺服器及將其整合到代理體驗中
  • 驅動式開發
  • 安全性最佳實踐
  • 使用功能、ACA 和 API 管理等構建模塊
  • 註冊表對齊及工具（1P + 3P）

如果您是開發者、工具建設者或 AI 產品策略師，第二天將提供構建可擴展、安全及未來準備的 MCP 解決方案所需的洞察。

MCP 訓練營 2025 年 8 月

透過密集的影片課程學習如何建立 MCP 伺服器、整合 VS Code 及基於 MCP 初學者課程內容在 Azure 上專業部署。掌握主要公司已在使用的技術的實用技能。

➡️隨選觀看 MCP 訓練營 | 英文

➡️隨選觀看 MCP 訓練營 | 巴西

➡️隨選觀看 MCP 訓練營 | 西班牙文

一起學習 MCP with C# - 教學系列

一起學習模型上下文協議（MCP），這是一個旨在標準化 AI 模型與客戶端應用之間交互的尖端框架。透過此初學者友好的課程，我們將向您介紹 MCP 並指導您建立第一個 MCP 伺服器。

C#: https://aka.ms/letslearnmcp-csharp

Java: https://aka.ms/letslearnmcp-java

JavaScript: https://aka.ms/letslearnmcp-javascript

Python: https://aka.ms/letslearnmcp-python

🌟 社群感謝

感謝 Microsoft Valued Professional Shivam Goyal 提供重要程式碼範例。

📜 授權資訊

此內容依據 MIT 授權 授權。條款及條件請參閱 LICENSE。

🤝 貢獻指南

此專案歡迎貢獻及建議。大多數貢獻需要您同意一份貢獻者授權協議（CLA），聲明您有權並實際授予我們使用您貢獻的權利。詳情請訪問 https://cla.opensource.microsoft.com。

當您提交拉取請求時，CLA 機器人將自動判斷您是否需要提供 CLA 並適當地標記 PR（例如，狀態檢查、評論）。只需按照機器人提供的指示操作即可。您只需在所有使用我們 CLA 的存儲庫中執行一次。

此專案已採用 Microsoft 開源行為準則。
如需更多資訊，請參閱 行為準則 FAQ 或聯繫 opencode@microsoft.com 提出其他問題或意見。

📂 存儲庫結構

此存儲庫的組織如下：

  • 核心課程 (00-11)：主要內容分為十一個連續模組，包括全面的資料庫整合實驗
  • 11-MCPServerHandsOnLabs/：完整的 13 篇實驗學習路徑，用於構建生產級 MCP 伺服器並整合 PostgreSQL
  • images/：課程中使用的圖表及插圖
  • translations/：多語言支援及自動翻譯
  • translated_images/：本地化版本的圖表及插圖
  • study_guide.md：全面的存儲庫導航指南
  • changelog.md：課程材料所有重要變更的記錄
  • mcp.json：MCP 規範的配置文件
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md：專案治理文件

🎒 其他課程

我們的團隊還製作其他課程！查看：

™️ 商標聲明

此專案可能包含專案、產品或服務的商標或標誌。使用 Microsoft 商標或標誌需獲得授權，並必須遵守 Microsoft 的商標與品牌指南。
在修改版本的專案中使用 Microsoft 商標或標誌不得引起混淆或暗示 Microsoft 的贊助。
任何使用第三方商標或標誌的行為需遵守該第三方的政策。

尋求協助

如果您遇到困難或對建立 AI 應用程式有任何疑問，請加入：

Azure AI Foundry Discord

如果您有產品反饋或在開發過程中遇到錯誤，請訪問：

Azure AI Foundry Developer Forum

免責聲明：
本文件已使用 AI 翻譯服務 Co-op Translator 進行翻譯。雖然我們致力於提供準確的翻譯，但請注意，自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應被視為權威來源。對於關鍵資訊，建議使用專業人工翻譯。我們對因使用此翻譯而引起的任何誤解或誤釋不承擔責任。