🌟 Microsoft Learn MCP 服务器

阻止 AI 幻觉。 让您的 AI 助手（Claude、Cursor、Copilot、Codex 等）直接访问最新的官方 Microsoft 文档。

✨ 免费。一键安装。无需密钥。

🎯 为什么要安装这个？

不要再依赖过时的训练数据或有风险的网络搜索。Learn MCP 服务器提供安全、直接的 Microsoft 官方文档访问。

• 🧠 消除幻觉。 阻止您的 AI 发明不存在的 Azure SDK 方法或编造库包。获取真正可以编译的代码。

• 🔌 即插即用（无需认证）。 无需 API 密钥、登录或注册。只需一键安装，即可立即开始编码。

• 🛡️ 100% 可信且安全。 保护您的供应链。与可能抓取不安全博客或恶意网站的通用网络搜索不同，此工具仅访问官方的第一方 Microsoft 文档。

• 💸 完全免费。 高搜索容量专为流畅、高强度的编码会话而设计。

✨ 示例提示

“请给我创建具有托管标识的 Azure 容器应用的 Azure CLI 命令。”

“Azure 欧盟区域是否已推出 gpt-5.4？”

“您确定这是在 .NET 8 极简 API 中实现 IHttpClientFactory 的正确方式吗？”

“请展示使用 Azure AI Foundry 评估 SDK 运行 Python 代码以执行危害评估的示例。”

🌐 Microsoft Learn MCP 服务器端点

Microsoft Learn MCP 服务器可被任何支持模型上下文协议 (MCP) 的 IDE、代理或工具访问。任何兼容客户端都可以连接到以下远程 MCP 服务器端点：

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

注意： 此 URL 旨在通过流式 HTTP 在合规的 MCP 客户端内使用，例如我们在“入门”部分中推荐的客户端。它不支持从网页浏览器直接访问，如果手动访问可能会返回 405 Method Not Allowed 错误。对于需要构建自己解决方案的开发者，请遵循“构建自定义客户端”部分中的强制性指南，以确保您的实现具有弹性和得到支持。

标准配置适用于大多数客户端：

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

有关实验性功能，请参阅下方的“实验性功能”部分。

🧪 实验性功能

Microsoft Learn MCP 服务器提供正在积极开发的实验性功能。这些功能可能会根据用户反馈和使用模式进行更改或优化。

OpenAI 兼容端点

对于需要 OpenAI Deep Research 模型兼容性的应用程序，您可以使用 OpenAI 兼容端点：

https://learn.microsoft.com/api/mcp/openai-compatible

此端点支持 OpenAI Deep Research 模型，并遵循 OpenAI 的 MCP 规范。

令牌预算控制

为了管理令牌使用并控制成本，您可以将 maxTokenBudget 查询参数附加到 MCP 服务器端点 URL 上。此参数通过截断内容来限制搜索工具响应中的令牌数量，以满足您指定的预算。

https://learn.microsoft.com/api/mcp?maxTokenBudget=2000

注意： 这些实验性功能可能会发生变化。我们欢迎通过我们的 GitHub Discussions 提供反馈。

🛠️ 当前支持的工具

工具名称	描述	输入参数
microsoft_docs_search	对 Microsoft 官方技术文档进行语义搜索	query（字符串）：用于检索的搜索查询
microsoft_docs_fetch	获取并把 Microsoft 文档页面转换成 Markdown 格式	url（字符串）：要读取的文档页面的 URL
microsoft_code_sample_search	搜索 Microsoft/Azure 官方代码片段和示例	query（字符串）：Microsoft/Azure 代码片段的搜索查询 language（字符串，可选）：编程语言筛选器

💻 Microsoft Learn CLI 预览版

@microsoft/learn-cli 包使您无需 MCP 客户端即可通过终端访问相同的功能——搜索文档、获取页面和查找代码示例。

# 即刻运行（无需安装）
npx @microsoft/learn-cli search "azure functions timeout"

# 或者全局安装
npm install -g @microsoft/learn-cli
# 然后使用 `mslearn`
mslearn search "azure functions timeout"

传递 --json 可以获得结构化的 JSON 输出，便于程序化处理：

mslearn search "azure openai" --json | jq '.results[].title'

完整命令参考请参阅 cli/README.md。

🤖 代理技能

Agent Skills 是便携式的指令包，可帮助 AI 代理更有效地使用工具。我们提供了三种技能，指导代理何时以及如何使用 Microsoft Learn MCP 工具：

技能	目的	最适合
microsoft-docs	理解概念、教程、架构、限制	“X 是如何工作的？”、“学习”、“配置指南”
microsoft-code-reference	API 查找、代码示例、验证、错误修复	实现代码、寻找正确方法、故障排除
microsoft-skill-creator	一种元技能，可为任何 Microsoft 技术生成自定义代理技能	创建技能以教导代理关于新的 Azure 库、.NET 功能或其他 Microsoft 技术

快速设置

这些代理技能与 Learn MCP 服务器一同打包在 microsoft-docs 插件中。如果您使用 Claude Code，请运行以下命令并重启 Claude Code：

/plugin install microsoft-docs@claude-plugins-official

或者，如果您使用 GitHub Copilot CLI，请运行此命令：

/plugin install microsoftdocs/mcp

否则，请按照以下步骤操作：

1. 先安装 MCP 服务器 — 请参阅下方的 安装与入门 部分。
2. 将技能文件夹复制到您项目的 .github/skills/ 或 .claude/skills/ 目录中：
   • microsoft-docs — 用于概念、教程和事实查询。
   • microsoft-code-reference — 用于 API 查询、代码示例和故障排除。
   • microsoft-skill-creator — 用于生成关于 Microsoft 技术的自定义技能的元技能。

支持的代理

Agent Skills 可在多个 AI 代理中使用：

• VS Code（Insiders 版）— 启用 chat.useAgentSkills 设置。
• GitHub Copilot CLI 和 Copilot 编程代理。
• Claude Code、Cursor、OpenAI Codex 等 更多。

我需要哪种技能？

如果您想…	安装
涵盖所有 Microsoft 文档场景	三个技能全部安装
专注于编码（API、示例、错误）	仅安装 microsoft-code-reference
专注于事实与概念（限制、配置、教程）	仅安装 microsoft-docs
为特定 Microsoft 技术生成自定义技能	仅安装 microsoft-skill-creator

🔌 安装与入门

Microsoft Learn MCP 服务器支持在多种开发环境中快速安装。请在下方选择您偏好的客户端，以进行简化的设置：

客户端	一键安装	MCP 指南
VS Code	或在扩展中搜索 “@mcp learn” 以显示 “Microsoft Learn” MCP	VS Code MCP 官方指南
GitHub Copilot CLI	/plugin install microsoftdocs/mcp
Claude Desktop	按照官方指南中的“添加自定义连接器”说明操作。	Claude Desktop 远程 MCP 指南
Claude Code	/plugin install microsoft-docs@claude-plugins-official（包含 MCP 服务器 + 技能）	Claude Code 远程 MCP 指南
Visual Studio	升级到最新版 VS 2022 或 2026，“Microsoft Learn” MCP 已内置	Visual Studio MCP 官方指南
Cursor IDE		Cursor MCP 官方指南
Codex	codex mcp add "microsoft-learn" --url "https://learn.microsoft.com/api/mcp"	Codex MCP 文档
Roo Code	打开 Roo Code 市场，搜索 “Microsoft Learn”，然后点击 “安装”	Roo Code MCP 官方指南
Cline	需要手动配置 使用 "type": "streamableHttp"	Cline MCP 官方指南
Gemini CLI	需要手动配置 查看配置 注意：将一个 mcpServer 对象添加到 .gemini/settings.json 文件中 { "Microsoft Learn MCP Server": { "httpUrl": "https://learn.microsoft.com/api/mcp" } }	如何设置您的 MCP 服务器
Qwen Code	需要手动配置 查看配置 注意：将一个 mcpServer 对象添加到 .qwen/settings.json 文件中 { "Microsoft Learn MCP Server": { "httpUrl": "https://learn.microsoft.com/api/mcp" } }	在 settings.json 中配置 MCP 服务器
GitHub	需要手动配置 查看配置 注意：前往 设置 → 编码代理 { "mslearn": { "type": "http", "url": "https://learn.microsoft.com/api/mcp", "tools": [ "*" ] } }
ChatGPT	需要手动配置 查看说明 1. 在浏览器中打开 ChatGPT 2. 前往 设置 → 连接器 → 高级设置 → 开启开发者模式 3. 返回连接器并点击 创建 4. 为连接器命名，输入 URL https://learn.microsoft.com/api/mcp，将 身份验证 设置为 无身份验证，并信任该应用 5. 点击 创建	ChatGPT 官方指南
Windsurf	需要手动配置 查看配置 { "mcpServers": { "microsoft-learn": { "serverUrl": "https://learn.microsoft.com/api/mcp" } } }	Windsurf MCP 指南
Kiro	查看配置 { "microsoft-learn": { "url": "https://learn.microsoft.com/api/mcp" } }	Kiro MCP 指南

⚠️ 构建自定义客户端

如果您的用例需要直接的程序化集成，务必了解 MCP 是一种 动态协议，而非静态 API。可用的工具及其架构会不断演进。

为了构建一个在服务更新时不会中断的稳健客户端，您应遵循以下原则：

1. 动态发现工具： 您的客户端应在运行时从服务器获取当前的工具定义（例如使用 tools/list）。请勿硬编码工具名称或参数。
2. 失败时刷新： 您的客户端应处理 tool/invoke 调用中的错误。如果工具调用因缺少工具或其架构已更改而失败（例如 HTTP 404 或 400 错误），您的客户端应假定其缓存已过时，并自动通过调用 tools/list 触发刷新。
3. 处理实时更新： 您的客户端应监听服务器通知（例如 listChanged），并相应地刷新其工具缓存。

❓ 故障排除

💻 系统提示

即使是像 Claude Sonnet 4 这样擅长使用工具的模型，默认情况下有时也会无法调用 MCP 工具；请使用系统提示来鼓励其使用。

以下是一个 Cursor 规则（系统提示）的示例，它会使 LLM 更频繁地使用 microsoft-learn：

## 查询 Microsoft 文档

您拥有名为 `microsoft_docs_search`、`microsoft_docs_fetch` 和 `microsoft_code_sample_search` 的 MCP 工具——这些工具允许您搜索和获取 Microsoft 最新的官方文档及代码示例，而这些信息可能比您训练数据集中的内容更加详细或更新。

当处理有关如何使用原生 Microsoft 技术的问题时，例如 C#、F#、ASP.NET Core、Microsoft.Extensions、NuGet、Entity Framework 以及 `dotnet` 运行时，请在面对具体且范围狭窄的问题时，使用这些工具进行研究。

⚠️ 常见问题

问题	可能的解决方案
连接错误	请检查您的网络连接，并确保服务器 URL 输入正确
没有返回结果	尝试使用更具体的技术术语重新表述您的查询
工具未在 VS Code 中显示	请重启 VS Code，或检查 MCP 扩展是否已正确安装
HTTP 状态 405	“方法不允许”错误通常发生在浏览器尝试连接到端点时。建议改用 VS Code GitHub Copilot 或 MCP Inspector 来访问 MCP 服务器。

🆘 获取支持

• 提问、分享想法
• 创建问题

📚 其他资源

• Microsoft Learn MCP 服务器产品文档
• Microsoft MCP 服务器项目
• Microsoft Learn
• 模型上下文协议规范

Microsoft Learn MCP Server 快速上手指南

Microsoft Learn MCP Server 是一个免费的官方工具，旨在让 AI 助手（如 Claude、Cursor、Copilot 等）直接访问最新的微软官方文档。它能有效消除 AI 幻觉，确保生成的代码基于真实存在的 API 和库，且无需任何 API 密钥或登录即可使用。

环境准备

• 支持的客户端：你需要一个支持 Model Context Protocol (MCP) 的 AI 开发工具。
  • 推荐：VS Code (最新版或 Insiders 版), Cursor, Claude Code, GitHub Copilot CLI, Visual Studio 2022/2026。
  • 其他支持 MCP 的工具（如 Cline, Roo Code, Codex 等）也可通过手动配置使用。
• 网络连接：需要能够访问 https://learn.microsoft.com。
• 前置依赖：
  • 若使用 VS Code/Cursor 等图形界面工具，无需额外安装依赖。
  • 若使用命令行工具，需安装 Node.js (用于运行 npx 或 npm)。

注意：目前该服务主要提供全球官方源，暂无专门的国内镜像加速方案。如遇网络延迟，请检查本地网络环境。

安装步骤

根据你的开发工具选择以下一种安装方式：

方式一：VS Code / Cursor (一键安装)

这是最简便的方式，点击链接即可自动配置。

• VS Code: 或者在扩展商店搜索 @mcp learn 找到 "Microsoft Learn" 并安装。

• Cursor:

方式二：Claude Code / GitHub Copilot CLI (插件命令)

在终端中运行以下命令安装插件（包含 MCP 服务器及增强技能的 Agent Skills）：

• Claude Code:

  /plugin install microsoft-docs@claude-plugins-official
  

  (安装后请重启 Claude Code)

• GitHub Copilot CLI:

  /plugin install microsoftdocs/mcp
  

方式三：手动配置 (通用)

如果你的工具不支持一键安装，请在 MCP 配置文件中添加以下服务器信息：

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

• Cline/Roo Code/Qwen/Gemini 等：通常在设置文件 (settings.json 或 MCP 配置页) 中添加上述 JSON 配置。注意部分工具可能需要将 type 设置为 streamableHttp。

方式四：纯命令行使用 (无需 MCP 客户端)

如果你只想在终端查询文档，可以使用官方 CLI 工具：

# 临时运行 (无需安装)
npx @microsoft/learn-cli search "azure functions timeout"

# 或全局安装
npm install -g @microsoft/learn-cli
# 安装后使用
mslearn search "azure functions timeout"

基本使用

安装完成后，直接在 AI 助手的对话框中提问即可。AI 会自动调用 Microsoft Learn 数据库获取最新信息。

使用示例

场景 1：查询具体的 CLI 命令

"Give me the Azure CLI commands to create an Azure Container App with a managed identity." (给我创建带有托管标识的 Azure Container App 的 Azure CLI 命令。)

场景 2：验证 API 可用性或版本信息

"Is gpt-5.4 available in Azure EU regions?" (gpt-5.4 在 Azure 欧盟区域可用吗？)

场景 3：确认代码实现是否正确

"Are you sure this is the right way to implement IHttpClientFactory in a .NET 8 minimal API?" (你确定这是在 .NET 8 Minimal API 中实现 IHttpClientFactory 的正确方法吗？)

场景 4：获取可运行的代码示例

"Show me runnable Python code to do harms eval using the Azure AI Foundry evaluation SDK." (展示使用 Azure AI Foundry 评估 SDK 进行危害评估的可运行 Python 代码。)

进阶技巧：控制 Token 用量

如果你需要限制返回内容的长度以节省 Token，可以在配置 URL 时添加参数（仅适用于支持自定义 URL 参数的客户端）：

https://learn.microsoft.com/api/mcp?maxTokenBudget=2000

核心功能说明

该工具主要提供以下三种能力供 AI 调用：

1. 语义搜索 (microsoft_docs_search)：在微软官方技术文档中进行智能搜索。
2. 页面抓取 (microsoft_docs_fetch)：将指定的微软文档页面转换为 Markdown 格式供 AI 阅读。
3. 代码示例搜索 (microsoft_code_sample_search)：专门搜索官方的代码片段和示例（支持按编程语言过滤）。