Microsoft Learn MCP Server

为AI助手提供权威、实时、免费无密钥的微软官方文档访问,杜绝AI幻觉。

Star 数
★ 2k
最近更新
1 个月前
License
CC-BY-4.0
主语言
TypeScript

30 秒速览

运行形态
MCP 服务器命令行工具Agent 插件 / 技能
可在哪里用
兼容但需适配ChatGPT · Codex · Claude Code · Claude.ai
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
Node.js(用于 npm)兼容 MCP 的客户端(VS Code、Copilot 等)Shell / 命令行网络访问
典型场景
开发者使用 Claude Code 或 Cursor 编写 Azure 代码时,通过 MCP 查询最新 API 用法,避免使用过时的训练数据。
不适合
  • 需要完全离线或内网隔离环境的团队,服务依赖微软托管端点
  • 需要浏览器直接打开链接查看结果的用户,端点不支持浏览器访问
  • 需要稳定不变工具接口的静态客户端,工具与 schema 会随服务演进

这个 Agent 能做什么,适合哪些场景?

Microsoft Learn MCP Server 是微软官方发布的服务,通过 Model Context Protocol (MCP) 向 Claude、Cursor、Copilot 等 AI 助手提供实时、可信的微软文档与代码示例检索能力。仓库包含一个远程 MCP 端点(https://learn.microsoft.com/api/mcp)、一个 CLI 工具(@microsoft/learn-cli)、以及三个 Agent Skills(用于指导 AI 何时使用工具)。整体设计遵循 MCP 协议,客户端可动态发现工具并调用。该服务完全免费,无需API密钥或登录。

该服务提供三个核心工具:microsoft_docs_search 对微软官方技术文档执行语义搜索;microsoft_docs_fetch 将文档页面转换为 Markdown;microsoft_code_sample_search 搜索官方代码片段并按语言过滤。CLI 工具(mslearn)提供相同功能,支持 --json 输出。MCP 端点通过 Streamable HTTP 协议工作,客户端可在运行时通过 tools/list 动态发现工具。Agent Skills 指导 AI 在概念理解、代码参考等场景下正确使用工具。

  1. 开发者使用 Claude Code 或 Cursor 编写 Azure 代码时,通过 MCP 查询最新 API 用法,避免使用过时的训练数据。
  2. AI 编码代理在实现 .NET 8 功能时,调用 microsoft_docs_fetch 获取官方文档确认正确方法。
  3. 技术作者编写微软技术教程时,使用 CLI 搜索并提取最新代码示例嵌入文档。
  4. 运维人员使用 OpenAI Codex 通过 MCP 查询 Azure CLI 命令,确保基础设施配置正确。
  5. AI 提示工程师需要验证 AI 生成的代码是否依赖不存在的 SDK 方法,使用该服务进行事实核查。

如何安装或部署这个 Agent?

在 VS Code 中,点击 Readme 中的一键安装按钮,或在扩展商店搜索 '@mcp learn' 安装 'Microsoft Learn'。其他客户端如 Claude Code 使用 /plugin install microsoft-docs@claude-plugins-official;Codex 使用 codex mcp add "microsoft-learn" --url "https://learn.microsoft.com/api/mcp"。CLI 工具通过 npm 安装:npm install -g @microsoft/learn-cli。无需API密钥或登录。

如何使用这个 Agent?

安装后,在支持的 MCP 客户端中,直接向 AI 提问即可自动触发工具调用。例如在 Claude 中问:“Give me the Azure CLI commands to create an Azure Container App with a managed identity.” 或使用 CLI:npx @microsoft/learn-cli search "azure functions timeout",加 --json 获取结构化输出。也可在系统提示中添加示例提示语,鼓励模型使用 MCP 工具。

这个 Agent 有哪些优点和局限?

优点
  • 完全免费,无需API密钥或注册,一键安装。
  • 仅访问微软官方文档,杜绝不安全的第三方内容,保证供应链安全。
  • 提供远程MCP端点,支持多种客户端(VS Code、Cursor、Codex等),无需本地部署。
  • 包含Agent Skills,指导AI正确使用工具,提升效果。
局限
  • 端点不支持浏览器直接访问,需要MCP客户端;使用静态API客户端可能因工具列表变更而出错。
  • 实验性功能(如OpenAI兼容端点、token预算控制)可能变更。
  • CLI工具为预览版,可能不稳定。
  • 依赖微软服务,若微软停止服务则无法使用。

这个 Agent 与同类方案有什么区别?

未在源码中明确提及替代品,但相比通用网页搜索,该服务仅索引官方文档,可避免不可信来源。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Microsoft Learn MCP Server 当前 43 · 缺口较多 MCP 服务器免费 ★ 2k 1 个月前 TypeScript ChatGPT · Codex · Claude Code · Claude.ai
Grounded Docs MCP 服务器 50 · 缺口较多 命令行工具免费 + 模型费 ★ 1.8k 今天 TypeScript ChatGPT · Claude Code
RepoBrain 代码库智能问答引擎 49 · 缺口较多 Agent 插件 / 技能免费 + 模型费 ★ 1.4k 3 天前 Python Codex · Claude Code
Obsidian Mind 79 · 表现良好 命令行工具免费 ★ 5.4k 1 天前 TypeScript Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
43/ 100 五分制 2.2 / 5
信任安全 6/29
可靠稳定 6/14
适用触发 10/18
规范维护 9/18
有效结果 9/13
证据核验 3/8
查看各维度的扣分理由
信任安全6 / 29 · 1.0/5

证据显示:工具仅访问官方Microsoft文档,无认证,权限最小化;但未提及用户确认机制,数据流透明度有限(仅说明访问官方文档),敏感数据处理未提及,依赖安全有SECURITY.md和CI构建,外部影响限于网络请求,回滚未提及,来源归属有官方文档链接。扣分:用户确认、敏感数据处理、回滚缺失。

可靠稳定6 / 14 · 2.1/5

证据显示:README与CLI文档一致,测试覆盖缓存和CLI功能,但依赖可用性未明确(依赖npm包),失败消息有基本错误处理但未详细。扣分:依赖可用性未验证,失败消息不够详细。

适用触发10 / 18 · 2.8/5

证据显示:面向多种AI代理和IDE,场景明确,能力边界有工具列表,环境适配有多个客户端配置,但触发精度未详细说明(如工具调用条件)。扣分:触发精度不足。

规范维护9 / 18 · 2.5/5

证据显示:信息架构清晰,安装说明详细,命名稳定(工具名固定),示例和FAQ丰富,已知限制有提及(如405错误),许可证为CC-BY-4.0,版本和变更日志未明确,维护责任有GitHub issues和讨论。扣分:版本和变更日志缺失,维护责任未明确。

有效结果9 / 13 · 3.5/5

证据显示:输出格式可用(JSON和文本),边际价值高(减少幻觉),成本效益好(免费)。扣分:无。

证据核验3 / 8 · 1.9/5

证据显示:README声称功能,但无独立验证,跨来源佐证有限(仅官方文档),事实与推断分离不明确。扣分:缺乏独立验证和跨来源佐证。

风险与缓解建议
  • 源码中未见:执行前用户确认开启或自行加上执行前确认;先在沙箱或测试环境跑通,确认行为后再接入真实数据。
  • 源码中未见:敏感信息处理使用专用、低权限、可随时吊销的 API 密钥,不要复用生产凭据,也不要让密钥出现在日志里。
  • 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
  • 发布者身份未验证,需谨慎对待。
  • 未提及用户确认机制,可能自动执行操作。
  • 敏感数据处理未说明,需注意隐私。
  • 依赖安全未完全验证,需检查npm包。
  • 版本和变更日志缺失,更新跟踪困难。
证据充分度:低 评估于 2026年8月14日 审查版本 caa3d670bf28 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →

常见问题

使用该服务需要付费吗?
完全免费,无需API密钥或订阅。
能否在浏览器中直接访问MCP端点?
不能,端点仅支持MCP客户端,浏览器访问会返回405错误。
工具列表会不会变化?如何避免集成出错?
MCP是动态协议,工具可能变化。建议客户端运行时动态发现工具,并在调用失败时刷新缓存。
支持哪些编程语言的代码示例搜索?
支持语言过滤,但具体语言列表未在文档中列出。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents