MCP

🚀 微軟學習MCP服務器

微軟學習MCP服務器是一個遠程MCP服務器，它能讓GitHub Copilot等客戶端和其他AI代理直接從微軟官方文檔中獲取可靠且最新的信息。該服務器支持可流式傳輸的HTTP傳輸，便於客戶端輕量級使用。

請注意，此項目處於公開預覽階段，在正式發佈之前，其實現可能會有重大更改。

🚀 快速開始

項目概述

✨ 示例提示：權威信息源

你的AI助手應能自動使用這些工具處理與微軟相關的主題。藉助搜索和獲取功能，你可以快速獲得答案或進行全面深入的研究。為確保AI助手始終參考官方文檔，你可以添加“search Microsoft docs”（搜索微軟文檔）、“deep dive”（深入研究）、“fetch full doc”（獲取完整文檔）等短語。

快速搜索與參考

“請給出使用Azure CLI命令創建具有託管標識的Azure容器應用的方法。search Microsoft docs” “gpt - 4.1 - mini是否在歐盟地區可用？fetch full doc”

代碼驗證與最佳實踐

“在.NET 8最小API中實現IHttpClientFactory的這種方式是否正確？search Microsoft docs and fetch full doc” “請展示在ASP.NET Core中實現身份驗證的完整指南。fetch full doc”

全面學習與深入研究

“我需要全面瞭解Azure Functions。search Microsoft docs and deep dive” “請提供將.NET應用程序部署到Azure應用服務的完整分步教程。search Microsoft docs and deep dive”

📊 關鍵能力

• 高質量內容檢索：以Markdown格式從微軟官方文檔中搜索和檢索相關內容。
• 語義理解：使用高級向量搜索為任何查詢找到最具上下文相關性的文檔。
• 即時更新：在微軟發佈最新文檔時即可訪問。

🌐 微軟學習MCP服務器端點

任何支持模型上下文協議（MCP）的IDE、代理或工具都可以訪問微軟學習MCP服務器。任何兼容的客戶端都可以連接到以下遠程MCP端點：

https://learn.microsoft.com/api/mcp

注意：此URL旨在通過可流式傳輸的HTTP在兼容的MCP客戶端中使用，例如我們安裝與入門部分列出的推薦客戶端。它不支持從Web瀏覽器直接訪問，如果手動訪問可能會返回405 Method Not Allowed錯誤。對於需要構建自己解決方案的開發人員，請遵循構建自定義客戶端部分中的強制指南，以確保你的實現具有彈性並得到支持。

示例JSON配置：

{
  "microsoft.docs.mcp": {
    "type": "http",
    "url": "https://learn.microsoft.com/api/mcp"
  }
}

🛠️ 當前支持的工具

🔌 安裝與入門

微軟學習MCP服務器支持在多個開發環境中快速安裝。請選擇你喜歡的客戶端進行簡化設置：

客戶端	一鍵安裝	MCP指南
VS Code		VS Code MCP官方指南
Claude Desktop	查看說明 1. 打開Claude Desktop 2. 轉到設置 → 集成 3. 點擊添加集成 4. 輸入URL：https://learn.microsoft.com/api/mcp 5. 點擊連接	Claude Desktop遠程MCP指南
Claude Code	查看說明 1. 打開CLI 2. 輸入claude mcp add --transport http microsoft_docs_mcp https://learn.microsoft.com/api/mcp並按回車鍵 3. （可選）在claude mcp add之後直接輸入--scope user，使此MCP服務器在Claude Code的所有項目中可用	Claude Code遠程MCP指南
Visual Studio	需要手動配置 使用"type": "http"	Visual Studio MCP官方指南
Cursor IDE		Cursor MCP官方指南
Roo Code	需要手動配置 使用"type": "streamable-http"	Roo Code MCP官方指南
Cline	需要手動配置 使用"type": "streamableHttp"	Cline MCP官方指南
Gemini CLI	需要手動配置 查看配置 注意：在.gemini/settings.json文件中添加一個mcpServer對象 { "Microsoft Learn MCP Server": { "httpUrl": "https://learn.microsoft.com/api/mcp" } }	如何設置你的MCP服務器
Qwen Code	需要手動配置 查看配置 注意：在.qwen/settings.json文件中添加一個mcpServer對象 { "Microsoft Learn MCP Server": { "httpUrl": "https://learn.microsoft.com/api/mcp" } }	在settings.json中配置MCP服務器
GitHub	需要手動配置 查看配置 注意：導航到設置 → 編碼代理 { "mslearn": { "command": "npx", "args": [ "-y", "mcp-remote", "https://learn.microsoft.com/api/mcp" ], "tools":["*"] } }
ChatGPT	需要手動配置 查看說明 1. 在瀏覽器中打開ChatGPT 2. 轉到設置 → 連接器 → 高級設置 → 開啟開發者模式 3. 返回連接器並點擊創建 4. 為連接器命名，輸入URL https://learn.microsoft.com/api/mcp，將身份驗證設置為No authentication並信任該應用程序 5. 點擊創建	ChatGPT官方指南

替代安裝方法（適用於舊版客戶端或本地配置）

對於不支持原生遠程MCP服務器的客戶端，或者你更喜歡本地配置，可以使用mcp-remote作為代理：

{
  "microsoft.docs.mcp": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://learn.microsoft.com/api/mcp"
    ]
  }
}

{
  "microsoft.docs.mcp": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://learn.microsoft.com/api/mcp"
    ]
  }
}

{
  "microsoft.docs.mcp": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://learn.microsoft.com/api/mcp"
    ]
  }
}

▶️ 入門步驟

1. 對於VS Code：在VS Code中打開GitHub Copilot並切換到代理模式。
2. 對於Claude Desktop：添加集成後，你會在聊天界面中看到MCP工具圖標。
3. 你應該會在可用工具列表中看到學習MCP服務器。
4. 嘗試使用一個提示，告訴代理使用MCP服務器，例如“根據微軟學習官方文檔，創建Azure容器應用的az cli命令有哪些？”
5. 代理應該能夠使用MCP服務器工具來完成你的查詢。

⚠️ 構建自定義客戶端

如果你的用例需要直接的編程集成，必須明白MCP是一個動態協議，而不是靜態API。可用工具及其架構將會發展。

為了構建一個在服務更新時不會中斷的可靠客戶端，你應該遵循以下原則：

1. 動態發現工具：你的客戶端應在運行時從服務器獲取當前工具定義（例如，使用tools/list）。不要硬編碼工具名稱或參數。
2. 失敗時刷新：你的客戶端應處理tool/invoke調用期間的錯誤。如果工具調用失敗並返回表示工具缺失或其架構已更改的錯誤（例如，HTTP 404或400錯誤），你的客戶端應假設其緩存已過期，並通過調用tools/list自動觸發刷新。
3. 處理即時更新：你的客戶端應監聽服務器通知（例如，listChanged）並相應地刷新其工具緩存。

❓ 故障排除

💻 系統提示

即使像Claude Sonnet 4這樣對工具友好的模型，有時也默認不會調用MCP工具；可以使用系統提示來鼓勵使用。

以下是一個Cursor規則（系統提示）示例，它會使大語言模型更頻繁地使用microsoft.docs.mcp：

## 查詢微軟文檔

你可以使用名為`microsoft_docs_search`和`microsoft_docs_fetch`的MCP工具 - 這些工具允許你搜索和獲取微軟最新的官方文檔，這些信息可能比你的訓練數據集更詳細或更新。

在處理有關如何使用原生微軟技術（如C#、F#、ASP.NET Core、Microsoft.Extensions、NuGet、Entity Framework、`dotnet`運行時）的問題時 - 當遇到特定/狹義定義的問題時，請使用此工具進行研究。

⚠️ 常見問題

🆘 獲取支持

• 提問、分享想法
• 創建問題

🔮 未來改進

微軟學習MCP服務器團隊正在進行多項改進：

• microsoft_code_search工具：幫助代理找到準確的微軟官方示例代碼片段。
• 改進遙測功能，以幫助改進服務器。
• 擴大對其他微軟文檔源的覆蓋範圍。
• 改進查詢理解，以獲得更精確的結果。

📚 額外資源

• 微軟學習MCP服務器產品文檔
• 微軟MCP服務器
• 微軟學習
• 模型上下文協議規範