跟隨以下步驟開始使用這些資源：

Fork 該儲存庫：點擊
Clone 該儲存庫： git clone https://github.com/microsoft/mcp-for-beginners.git
加入

🌐 多語言支援

透過 GitHub Actions 支援（自動化且持續更新）

想本地 Clone？

本儲存庫包含 50 多種語言翻譯，這會顯著增加下載大小。如要不包含翻譯的 clone，請使用 sparse checkout：

Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'
CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"
這樣你可以更快下載所有完成課程所需內容。

🚀 新手入門 Model Context Protocol (MCP) 課程

透過 C#, Java, JavaScript, Rust, Python 和 TypeScript 的實作範例學習 MCP

🧠 Model Context Protocol 課程概覽

歡迎展開你的 Model Context Protocol 之旅！如果你曾好奇人工智能應用程式如何與不同工具和服務溝通，你即將發現這個正改變開發者構建智慧系統的優雅解決方案。

把 MCP 想像成 AI 應用程式的萬用翻譯器——就像 USB 連接埠讓你能將任何裝置接到電腦一樣，MCP 允許 AI 模型用標準化方式連接任何工具或服務。無論你是在打造你的第一個聊天機械人，或是處理複雜的 AI 工作流程，理解 MCP 都能讓你創建更強大靈活的應用程式。

本課程以耐心及細心設計你的學習路程。我們會從你已熟悉的簡單概念開始，並透過你喜歡的程式語言逐步累積實務經驗。每個步驟都包含清晰解說、實際範例，並伴隨鼓勵。

完成這趟旅程時，你將自信地能建置自己的 MCP 伺服器，將它們整合進受歡迎的 AI 平台，並了解這項技術如何重塑 AI 開發的未來。讓我們一同展開這刺激的冒險吧！

官方文件與規範

本課程依據 MCP Specification 2025-11-25 （最新穩定版本）設計。MCP 規範採用基於日期的版本號（YYYY-MM-DD 格式），確保協定版本明確可追蹤。

隨著你對 MCP 的理解加深，這些資源會越來越有價值，但不用急著一次看完。先從你最感興趣的區域開始！

📘 MCP 文件 – 這是你的逐步教學及用戶指南的首選資源。文件針對初學者編寫，提供清楚範例讓你跟著練習。
📜 MCP 規範 – 你可以把它當成全面的參考手冊。學習過程中，常會回來查特定細節及探索進階功能。
📜 MCP 規範版本管理 – 說明協定歷史版本及 MCP 如何使用日期版本號（YYYY-MM-DD 格式）。
🧑‍💻 MCP GitHub 儲存庫 – 這裡有多種程式語言的 SDK、工具和程式範例。猶如實用範例與即用元件的寶庫。
🌐 MCP 社群 – 加入其他學習者與經驗豐富開發者的討論。這是一個支持性社群，歡迎提問，自由分享知識。

學習目標

完成本課程後，你會對新技能感到自信與興奮。你將達成以下目標：

• 了解 MCP 基礎：你將掌握 Model Context Protocol 是什麼，以及它為何革命性地改變 AI 應用如何合作，透過易懂的類比與範例。

• 建置你的第一個 MCP 伺服器：你會用自己慣用的程式語言建立一個運作中的 MCP 伺服器，從簡單範例開始，逐步成長技能。

• 將 AI 模型連接至真實工具：你會學會如何填補 AI 模型與實際服務間的落差，賦予應用更強大的新能力。

• 實踐安全最佳做法：你會了解如何保障 MCP 實作的安全，保護你的應用及使用者。

• 自信佈署：你會知道如何將 MCP 專案從開發帶到生產環境，採用符合實務的佈署策略。

• 加入 MCP 社群：你將成為不斷壯大的開發者社群一員，共同塑造 AI 應用開發的未來。

重要背景知識

在深入 MCP 細節之前，先確認你對一些基礎觀念感到舒適。別擔心你不是這些領域的專家——我們會一路說明你需要知道的一切！

了解協定（基礎）

把協定想像成人與人之間對話的規則。當你打電話給朋友，你倆都知道接電話時說「哈囉」、輪流說話，結束時說「再見」。電腦程式也需要相似規則來有效溝通。

MCP 是一套協定——一組約定的規則協助 AI 模型與應用程式有成效地「對話」，仿如對話規則能使人溝通更順暢，MCP 讓 AI 應用的溝通更可靠、更強大。

用戶端-伺服器關係（程式如何協同工作）

你每天都在用用戶端-伺服器關係！當你使用瀏覽器（用戶端）造訪網頁時，你是連接一台網頁伺服器，它會送出頁面內容。瀏覽器知道如何發出請求，伺服器知道如何回應。

在 MCP 中，我們有類似的關係：AI 模型充當用戶端，請求資訊或操作，而 MCP 伺服器提供這些能力。就像 AI 有一個幫手（伺服器），能被請求執行指定任務。

為何標準化重要（讓事物協同工作）

想像如果每家車廠的加油口形狀不同——你需用不同轉接器接油槍！標準化就是協議共用方式，使事物能無縫合作。

MCP 就是為 AI 應用提供此標準。不是每個 AI 模型都要寫特製的程式去配合每種工具，MCP 打造通用溝通方式。這表示開發者一次設計工具，能用於多種不同 AI 系統。

🧭 你的學習路徑概覽

你的 MCP 旅程經過精心規劃，逐步建立自信與技能。每階段帶入新概念，同時強化先前所學。

🌱 基礎階段：理解基本概念（模組 0-2）

冒險從這裡開始！我們將用熟悉的類比及簡單範例介紹 MCP 觀念。你會明白 MCP 是什麼、為什麼存在，以及它在 AI 開發大環境中的定位。

• 模組 0 - MCP 簡介：從探討 MCP 是什麼及其現代 AI 應用中的重要性開始。你會看到 MCP 真實案例，並了解它如何解決開發者常見挑戰。

• 模組 1 - 核心概念詳解：你將掌握 MCP 的基本構件。我們會用大量類比與視覺化範例，確保你能自然理解這些概念。

• 模組 2 - MCP 的安全：安全聽起來可能嚇人，我們會展示 MCP 包含的內建安全功能，並教授保護應用從一開始就安全的最佳做法。

🔨 建置階段：打造你的第一個實作（模組 3）

真正的樂趣現在開始！你將親自動手製作 MCP 伺服器和用戶端。別擔心——我們會從簡單開始，並引導你完成每一步。此模組包含多個實作指南，讓您能使用偏好的程式語言練習。您將建立第一個伺服器，開發連接該伺服器的客戶端，甚至整合像 VS Code 等流行的開發工具。

每個指南均包含完整程式碼範例、故障排除技巧，以及我們為何作出特定設計決策的說明。完成此階段後，您將擁有可以自豪的可用 MCP 實作！

🚀 成長階段：進階概念與實務應用（模組4-5）

掌握基礎後，您將準備探索更複雜的 MCP 功能。我們會涵蓋實務實作策略、除錯技巧，以及像多模態 AI 整合等進階主題。

您也將學習如何擴展 MCP 實作以應付生產環境，以及整合 Azure 等雲端平台。這些模組將幫助您打造能因應現實需求的 MCP 解決方案。

🌟 精通階段：社群與專業領域（模組6-11）

最後階段著重於加入 MCP 社群，並專精您最感興趣的領域。您將學習如何為開源 MCP 專案做出貢獻，實作進階身份驗證模式，並建構完整的資料庫整合方案。

模組11值得特別一提 — 它包含完整的13個實作實驗室，教授您如何建置具有 PostgreSQL 整合的生產級 MCP 伺服器。這就像一個結業專案，綜合您所學的一切！

📚 完整課程結構

模組	主題	說明	連結
模組 0-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	stdio 伺服器	使用 stdio 傳輸建立伺服器	指南
3.6	HTTP 串流	在 MCP 中實作 HTTP 串流	指南
3.7	AI 工具包	使用 MCP 搭配 AI 工具包	指南
3.8	測試	測試您的 MCP 伺服器實作	指南
3.9	部署	將 MCP 伺服器部署到生產環境	指南
3.10	進階伺服器使用	使用進階伺服器以啟用進階功能與優化架構	指南
3.11	簡易認證	從頭教您認證與 Role-Based Access Control (RBAC)	指南
3.12	MCP 主機	設定 Claude Desktop、Cursor、Cline 及其他 MCP 主機	指南
3.13	MCP 檢查器	使用 Inspector 工具除錯與測試 MCP 伺服器	指南
3.14	採樣	用採樣技術與客戶端協作	指南

| 模組 4-5：實務與進階 | | | | | 04 | 實務實作 | SDK、除錯、測試、可重用提示模板 | 閱讀更多 | | 4.1 | 分頁 | 使用游標分頁處理大量結果集 | 指南 | | 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 自訂傳輸層 | 自訂傳輸層實作 | 指南 | | 5.16 | 協議功能 | 進度通知、取消、資源模板 | 指南 | | 模組 6-10：社群與最佳實務 | | | | | 06 | 社群貢獻 | 如何為 MCP 生態系做出貢獻 | 指南 | | 07 | 早期採用經驗分享 | 真實世界實作故事 | 指南 | | 08 | MCP 最佳實務 | 性能、容錯、韌性 | 指南 | | 09 | MCP 案例研究 | 實務實作範例 | 指南 | | 10 | 實作工作坊 | 使用 AI 工具包建置 MCP 伺服器 | 實驗室 | | 模組 11：MCP 伺服器實作實驗室 | | | | | 11 | MCP 伺服器資料庫整合 | 包含13個實驗室完整的 PostgreSQL 整合學習路徑 | 實驗室 | | 11.1 | 簡介 | MCP 與資料庫整合概述及零售分析使用案例 | 實驗室 00 | | 11.2 | 核心架構 | 理解 MCP 伺服器架構、資料庫層與安全模式 | 實驗室 01 | | 11.3 | 安全與多租戶 | 行級安全、認證與多租戶資料存取 | 實驗室 02 | | 11.4 | 環境設定 | 建置開發環境、Docker、Azure 資源 | 實驗室 03 | | 11.5 | 資料庫設計 | PostgreSQL 設定、零售架構設計與範例資料 | 實驗室 04 | | 11.6 | MCP 伺服器實作 | 建置含資料庫整合的 FastMCP 伺服器 | 實驗室 05 | | 11.7 | 工具開發 | 建立資料庫查詢工具與架構檢視 | 實驗室 06 | | 11.8 | 語意搜尋 | 使用 Azure OpenAI 與 pgvector 實作向量嵌入 | 實驗室 07 | | 11.9 | 測試與除錯 | 測試策略、除錯工具與驗證方法 | 實驗室 08 | | 11.10 | VS Code 整合 | 設定 VS Code MCP 整合與 AI 聊天功能 | 實驗室 09 | | 11.11 | 部署策略 | Docker 部署、Azure 容器應用與擴展考量 | 實驗室 10 | | 11.12 | 監控 | Application Insights、日誌、效能監控 | 實驗室 11 | | 11.13 | 最佳實務 | 性能優化、安全強化與生產環境提示 | 實驗室 12 |

💻 範例程式碼專案

學習 MCP 最令人興奮的部分之一是見證您的程式技巧逐步成長。我們設計的程式碼範例從簡單開始，隨著理解加深逐漸變得更為複雜。以下是我們引入概念的方式 — 程式碼易於理解，卻展示真實的 MCP 原則，讓您不僅了解程式碼做什麼，也知道為何這樣架構，以及它如何融入更大規模的 MCP 應用。

基本 MCP 計算器範例

語言	說明	連結
C#	MCP 伺服器範例	檢視程式碼
Java	MCP 計算器	檢視程式碼
JavaScript	MCP 示範	檢視程式碼
Python	MCP 伺服器	檢視程式碼
TypeScript	MCP 範例	檢視程式碼
Rust	MCP 範例	檢視程式碼

進階 MCP 實作

語言	說明	連結
C#	進階範例	檢視程式碼
Java with Spring	容器應用範例	檢視程式碼
JavaScript	進階範例	檢視程式碼
Python	複雜實作	檢視程式碼
TypeScript	容器樣本	檢視程式碼