按照以下步驟開始使用這些資源:
- Fork 此儲存庫:點擊
- Clone 此儲存庫:
git clone https://github.com/microsoft/mcp-for-beginners.git
- 加入 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 文件 – 詳細教程和使用指南
- 📜 MCP 規範 – 協議架構和技術參考
- 📜 原始 MCP 規範 – 傳統技術參考(可能包含更多細節)
- 🧑💻 MCP GitHub 儲存庫 – 開源 SDK、工具和程式碼範例
- 🌐 MCP 社群 – 加入討論並為社群做出貢獻
🧭 MCP 課程概述
📚 完整課程結構
模組 | 主題 | 描述 | 連結 |
---|---|---|---|
模組 1-3:基礎知識 | |||
00 | MCP 簡介 | MCP 的概述及其在 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 | stdio 伺服器 | 使用 stdio 傳輸建立伺服器 | 指南 |
3.6 | HTTP 串流 | 在 MCP 中實作 HTTP 串流 | 指南 |
3.7 | AI 工具包 | 使用 MCP 的 AI 工具包 | 指南 |
3.8 | 測試 | 測試您的 MCP 伺服器實作 | 指南 |
3.9 | 部署 | 將 MCP 伺服器部署到生產環境 | 指南 |
3.10 | 高級伺服器使用 | 使用高級伺服器以實現高級功能和改進架構 | 指南 |
3.11 | 簡單身份驗證 | 從基礎開始展示身份驗證和 RBAC | 指南 |
模組 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 | 上下文工程 | 有效上下文工程的技巧 | 指南 |
5.15 | MCP 自定義傳輸 | 自定義傳輸的實作 | 指南 |
模組 6-10:社群與最佳實踐 | |||
06 | 社群貢獻 | 如何為 MCP 生態系統做出貢獻 | 指南 |
07 | 早期採用的洞察 | 真實世界的實作故事 | 指南 |
08 | MCP 的最佳實踐 | 性能、容錯、韌性 | 指南 |
09 | MCP 案例研究 | 實際的實作範例 | 指南 |
10 | 實作工作坊 | 使用 AI 工具包建立 MCP 伺服器 | 實驗室 |
模組 11:MCP 伺服器實作實驗室 | |||
11 | MCP 伺服器資料庫整合 | 涵蓋 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.6 | MCP 伺服器實作 | 建立與資料庫整合的 FastMCP 伺服器 | Lab 05 |
11.7 | 工具開發 | 創建資料庫查詢工具及架構檢視 | Lab 06 |
11.8 | 語義搜尋 | 使用 Azure OpenAI 和 pgvector 實現向量嵌入 | Lab 07 |
11.9 | 測試與除錯 | 測試策略、除錯工具及驗證方法 | Lab 08 |
11.10 | VS 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 伺服器範例 | 查看程式碼 |
Java | MCP 計算器 | 查看程式碼 |
JavaScript | MCP 示範 | 查看程式碼 |
Python | MCP 伺服器 | 查看程式碼 |
TypeScript | MCP 範例 | 查看程式碼 |
Rust | MCP 範例 | 查看程式碼 |
高級 MCP 實作
語言 | 描述 | 連結 |
---|---|---|
C# | 高級範例 | 查看程式碼 |
Java with Spring | 容器應用範例 | 查看程式碼 |
JavaScript | 高級範例 | 查看程式碼 |
Python | 複雜實作 | 查看程式碼 |
TypeScript | 容器範例 | 查看程式碼 |
🎯 學習 MCP 的先決條件
為了充分利用此課程內容,您應具備以下知識:
至少熟悉以下其中一種程式語言:C#、Java、JavaScript、Python 或 TypeScript
了解客戶端-伺服器模型及 API
熟悉 REST 和 HTTP 概念
(選擇性)具備 AI/ML 概念背景
加入我們的社群討論以獲得支援
📚 學習指南與資源
此存儲庫包含多種資源,幫助您有效學習:
學習指南
提供一份全面的 學習指南,幫助您有效瀏覽此存儲庫。指南包括:
- 顯示所有涵蓋主題的視覺課程地圖
- 每個存儲庫部分的詳細分解
- 使用範例專案的指導
- 根據不同技能水平推薦的學習路徑
- 補充學習旅程的額外資源
更新記錄
我們維護了一份詳細的 更新記錄,追蹤課程材料的所有重要更新,包括:
- 新內容添加
- 結構變更
- 功能改進
- 文件更新
🛠️ 如何有效使用此課程
此指南中的每節課程包括:
- 清晰的 MCP 概念解釋
- 多種程式語言的即時程式碼範例
- 建立真實 MCP 應用的練習
- 提供進階學習者的額外資源
活動
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 與 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:專案治理文件
🎒 其他課程
我們的團隊還製作其他課程!查看:
- 新 初學者的邊緣 AI
- 初學者的 AI 代理
- 使用 .NET 的生成式 AI 初學者課程
- 使用 JavaScript 的生成式 AI 初學者課程
- 生成式 AI 初學者課程
- 使用 Java 的生成式 AI 初學者課程
- 初學者的機器學習
- 初學者的資料科學
- 初學者的人工智慧
- 初學者的網路安全
- 初學者的網頁開發
- 初學者的物聯網
- 初學者的 XR 開發
- 掌握 GitHub Copilot 進行 AI 配對編程
- 掌握 GitHub Copilot:C#/.NET 開發者指南
- 選擇你的 Copilot 冒險之旅
™️ 商標聲明
此項目可能包含與項目、產品或服務相關的商標或標誌。使用 Microsoft 商標或標誌需經授權,並必須遵守 Microsoft 的商標與品牌準則。
在修改版本的項目中使用 Microsoft 商標或標誌時,不得引起混淆或暗示 Microsoft 的贊助。
任何第三方商標或標誌的使用需遵守相關第三方的政策。
尋求幫助
如果你遇到困難或對構建 AI 應用有任何疑問,請加入:
如果你有產品反饋或在構建過程中遇到錯誤,請訪問:
免責聲明:
本文件已使用人工智能翻譯服務 Co-op Translator 進行翻譯。儘管我們致力於提供準確的翻譯,請注意自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應被視為權威來源。對於重要資訊,建議使用專業人工翻譯。我們對因使用此翻譯而引起的任何誤解或錯誤解釋概不負責。