mcpField
M
microsoft-docs

microsoft-docs

github.com/microsoft开发3.2k120 次安装今天更新
代码仓库

关于 microsoft-docs

用于查找 Microsoft Learn 内容并获取完整页面的文档检索技能。支持针对概念、教程、配置、限制和最佳实践进行查询,也提供 `mslearn` 命令行替代方式。

主要功能

  1. 01搜索 Microsoft 文档
  2. 02获取完整文档页面
  3. 03提供精准查询指南
  4. 04提供 `mslearn` 命令行替代方式

适用场景

  1. 01查询服务概念和架构
  2. 02查找教程及配置详情
  3. 03核实服务限制或最佳实践

MCP 相关

通过 `microsoft_docs_search` 和 `microsoft_docs_fetch` 工具搜索并获取 MCP 中的 Microsoft 文档。如果 Learn MCP 服务不可用,文档提供了对应的 `mslearn` 命令行用法。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/microsoft/skills --skill microsoft-docs

安装后在 Claude Code 中输入/microsoft-docs确认已加载。

详细介绍

Microsoft Docs

工具

工具用途
microsoft_docs_search查找文档——概念、指南、教程、配置
microsoft_docs_fetch获取完整页面内容(搜索摘要不够时)

使用场景

  • 了解概念 — “Cosmos DB 分区如何工作?”
  • 学习服务 — “Azure Functions 概述”、“Container Apps 架构”
  • 查找教程 — “quickstart”、“getting started”、“step-by-step”
  • 配置选项 — “App Service 配置设置”
  • 限制和配额 — “Azure OpenAI 速率限制”、“Service Bus 配额”
  • 最佳实践 — “Azure 安全最佳实践”

查询效果

好的查询应具体明确:

# ❌ Too broad
"Azure Functions"

# ✅ Specific
"Azure Functions Python v2 programming model"
"Cosmos DB partition key design best practices"
"Container Apps scaling rules KEDA"

包含上下文:

  • 版本(如适用)(.NET 8、EF Core 8)
  • 任务意图(quickstart、tutorial、overview、limits)
  • 平台(适用于多平台文档)(Linux、Windows)

何时获取完整页面

在搜索后获取完整页面的情况:

  • 教程 — 需要完整的分步说明
  • 配置指南 — 需要列出所有选项
  • 深入探讨 — 用户需要全面介绍
  • 搜索摘要被截断 — 需要完整上下文

为什么使用它

  • 准确性 — 实时文档,而非可能过时的训练数据
  • 完整性 — 教程包含所有步骤,而非零散片段
  • 权威性 — Microsoft 官方文档

CLI 替代方案

如果 Learn MCP 服务不可用,可改用命令行中的 mslearn CLI:

# Run directly (no install needed)
npx @microsoft/learn-cli search "azure functions timeout"

# Or install globally, then run
npm install -g @microsoft/learn-cli
mslearn search "azure functions timeout"
MCP 工具CLI 命令
microsoft_docs_search(query: "...")mslearn search "..."
microsoft_docs_fetch(url: "...")mslearn fetch "..."

fetch 命令还支持使用 --section <heading> 提取单个章节,并使用 --max-chars <number> 截断输出。

评论

支持 Markdown