Skip to content

Latest commit

 

History

History
264 lines (194 loc) · 17.1 KB

File metadata and controls

264 lines (194 loc) · 17.1 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. Clone 該儲存庫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 觀看直播。所有內容皆有錄製,活動結束後會在 Microsoft Developer YouTube 頻道上架。示範程式碼也會在 GitHub 上提供。

活動詳情

  • 日期:7 月 29 日(第一天)及 7 月 30 日(第二天)
  • 時間:每日太平洋標準時間上午 9:00
  • 地點:線上,隨時隨地皆可參加!

第一天:MCP 生產力、開發工具與社群

專注於協助開發者將 MCP 融入開發流程,並慶祝精彩的 MCP 社群。我們將邀請 Arcade、Block、Okta 和 Neon 等社群成員與合作夥伴,分享他們如何與 Microsoft 合作,打造開放且可擴充的 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 搭配大型語言模型的客戶端 整合大型語言模型 指南
3.4 VS Code 整合 在 VS Code 中使用 MCP 伺服器 指南
3.5 SSE 伺服器 使用 Server-Sent Events 建立伺服器 指南
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 進行身份驗證 Guide
5.13 Foundry 整合 與 Azure AI Foundry 整合 Guide
5.14 上下文工程 有效上下文工程的技巧 Guide
模組 6-10:社群與最佳實踐
06 社群貢獻 如何為 MCP 生態系統做出貢獻 Guide
07 早期採用見解 實際應用案例分享 Guide
08 MCP 最佳實踐 效能、容錯與韌性 Guide
09 MCP 案例研究 實務實作範例 Guide
10 實作工作坊 使用 AI 工具包建置 MCP 伺服器 Lab

💻 範例程式專案

基本 MCP 計算器範例

語言 說明 連結
C# MCP 伺服器範例 View Code
Java MCP 計算器 View Code
JavaScript MCP 示範 View Code
Python MCP 伺服器 View Code
TypeScript MCP 範例 View Code

進階 MCP 實作

語言 說明 連結
C# 進階範例 View Code
Java Container App 範例 View Code
JavaScript 進階範例 View Code
Python 複雜實作 View Code
TypeScript Container 範例 View Code

🎯 學習 MCP 的先決條件

為了充分利用本課程內容,您應該具備:

  • 至少熟悉以下其中一種程式語言的基礎知識:C#、Java、JavaScript、Python 或 TypeScript

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

  • 熟悉 REST 與 HTTP 概念

  • (選擇性)具備 AI/ML 相關背景知識

  • 參與我們的社群討論以獲得支援

📚 學習指南與資源

本儲存庫包含多項資源,協助您有效學習與導覽:

學習指南

提供一份完整的學習指南,幫助您有效掌握本儲存庫內容。指南包含:

  • 視覺化課程地圖,展示所有涵蓋主題
  • 各儲存庫區塊的詳細說明
  • 如何使用範例專案的指引
  • 針對不同技能層級的推薦學習路徑
  • 補充學習旅程的額外資源

變更紀錄

我們維護一份詳細的變更紀錄,追蹤課程材料的所有重要更新,包括:

  • 新增內容
  • 結構調整
  • 功能改進
  • 文件更新

🛠️ 如何有效使用本課程

本指南中的每堂課包含:

  1. 清晰的 MCP 概念說明
  2. 多種語言的即時程式範例
  3. 實作 MCP 應用的練習題
  4. 進階學習者的額外資源

🌟 社群感謝

感謝 Microsoft Valued Professional Shivam Goyal 貢獻重要的程式範例。

📜 授權資訊

本內容採用 MIT 授權條款。詳細條款請參閱 LICENSE

🤝 貢獻指南

本專案歡迎貢獻與建議。大多數貢獻需您同意 貢獻者授權協議(CLA),聲明您有權利且確實授權我們 使用您的貢獻。詳情請參閱 https://cla.opensource.microsoft.com

當您提交 Pull Request 時,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:專案治理文件

🎒 其他課程

我們團隊還製作了其他課程!歡迎參考:

™️ 商標聲明

本專案可能包含專案、產品或服務的商標或標誌。授權使用 Microsoft 商標或標誌須遵守並依循 Microsoft 商標與品牌指南。 在本專案修改版本中使用 Microsoft 商標或標誌,不得造成混淆或暗示 Microsoft 贊助。 任何第三方商標或標誌的使用,須遵守該第三方的相關政策。

免責聲明
本文件係使用 AI 翻譯服務 Co-op Translator 進行翻譯。雖然我們致力於確保準確性,但請注意,自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應視為權威來源。對於重要資訊,建議採用專業人工翻譯。我們不對因使用本翻譯而產生的任何誤解或誤釋負責。