aiproxy/mcp-servers/hosted/microsoftdocs

🌟 Microsoft Learn 文档 MCP 服务器

Microsoft Learn 文档 MCP 服务器实现了模型上下文协议 (MCP) 服务器，为 AI 助手提供对官方 Microsoft 文档的实时访问。

请注意，此项目处于公开预览阶段，在正式发布之前实现可能会发生重大变化。

📑 目录

• 🌟 Microsoft Learn 文档 MCP 服务器
  • 📑 目录
  • 🎯 概述
  • ✨ 什么是 Microsoft Learn 文档 MCP 服务器？
  • 📊 主要功能
  • 🌐 Microsoft Learn 文档 MCP 服务器端点
  • 🛠️ 当前支持的工具
  • 🔌 安装和入门
  • 替代安装（适用于旧版客户端或本地配置）
  • ▶️ 入门指南
  • ❓ 故障排除
  • 💻 系统提示
  • 查询 Microsoft 文档
  • ⚠️ 常见问题
  • 🆘 获取支持
  • 🔮 未来增强功能
  • 📚 其他资源

🎯 概述

✨ 什么是 Microsoft Learn 文档 MCP 服务器？

Microsoft 文档 MCP 服务器是一个云托管服务，使 GitHub Copilot 和 Cursor 等 MCP 主机能够直接从 Microsoft 官方文档中搜索和检索准确信息。通过实现标准化的模型上下文协议 (MCP)，此服务允许任何兼容的 AI 系统基于权威的 Microsoft 内容来支撑其响应。

📊 主要功能

• 高质量内容检索：从 Microsoft Learn、Azure 文档、Microsoft 365 文档和其他官方 Microsoft 来源搜索和检索相关内容。
• 语义理解：使用先进的向量搜索为任何查询找到最具上下文相关性的文档。
• 优化分块：返回最多 10 个高质量内容块（每个最多 500 个令牌），包含文章标题、URL 和自包含的内容摘录。
• 实时更新：访问最新发布的 Microsoft 文档。

🌐 Microsoft Learn 文档 MCP 服务器端点

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

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

注意： 此端点专为 MCP 客户端通过可流式 HTTP 进行程序化访问而设计。它不支持从 Web 浏览器直接访问，如果手动访问可能会返回 405 Method Not Allowed 错误。

示例 JSON 配置：

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

🛠️ 当前支持的工具

工具名称	描述	输入参数
microsoft_docs_search	对 Microsoft 官方技术文档执行语义搜索	query（字符串）：用于检索的搜索查询

🔌 安装和入门

Microsoft Learn 文档 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 指南
Visual Studio	需要手动配置 使用 "type": "http"	Visual Studio MCP 官方指南
Cursor IDE		Cursor MCP 官方指南
Roo Code	需要手动配置 使用 "type": "streamable-http"	Roo Code MCP 官方指南
Cline	需要手动配置 使用 "type": "streamableHttp"	Cline MCP 官方指南

替代安装（适用于旧版客户端或本地配置）

对于不支持原生远程 MCP 服务器的客户端或如果您更喜欢本地配置，可以使用 mcp-remote 作为代理：

客户端	手动配置	MCP 指南
Claude Desktop（旧版配置）	查看配置 注意：仅在设置 → 集成不起作用时使用 { "microsoft.docs.mcp": { "command": "npx", "args": [ "-y", "mcp-remote", "https://learn.microsoft.com/api/mcp" ] } } 添加到 claude_desktop_config.json	Claude Desktop MCP 指南
Windsurf	查看配置 { "microsoft.docs.mcp": { "command": "npx", "args": [ "-y", "mcp-remote", "https://learn.microsoft.com/api/mcp" ] } }	Windsurf MCP 指南

▶️ 入门指南

1. 对于 VS Code：在 VS Code 中打开 GitHub Copilot 并切换到代理模式
2. 对于 Claude Desktop：添加集成后，您将在聊天界面中看到 MCP 工具图标
3. 您应该在可用工具列表中看到 Learn 文档 MCP 服务器
4. 尝试一个提示，告诉代理使用文档 MCP 服务器，例如"根据官方 Microsoft Learn 文档，创建 Azure 容器应用的 az cli 命令是什么？"
5. 代理应该能够使用文档 MCP 服务器工具来完成您的查询

❓ 故障排除

💻 系统提示

即使是像 Claude Sonnet 4.0 这样的工具友好模型通常也不会默认调用 MCP 工具 - 它们需要通过"系统提示"的形式给予一些鼓励。

以下是 Cursor 规则（系统提示）的示例，它将使 LLM 更频繁地使用 microsoft.docs.mcp：

查询 Microsoft 文档

您可以访问名为 microsoft.docs.mcp 的 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 文档来源
• 改进查询理解以获得更精确的结果

📚 其他资源

• Microsoft MCP 服务器
• Microsoft Learn
• 模型上下文协议规范