mcpField
M
microsoft-docs

microsoft-docs

github.com/github开发40.5k14.9k 次安装1 天前更新
代码仓库

关于 microsoft-docs

用于查找 Microsoft 技术文档的研究技能，涵盖 Microsoft Learn 及指定的外部来源。它会引导用户选择合适的 MCP 工具或命令行，并建议编写聚焦的查询。

主要功能

  1. 01搜索 Microsoft Learn 文档
  2. 02搜索代码示例
  3. 03获取完整文档页面
  4. 04转向外部文档来源
  5. 05提供对应的 mslearn 命令

适用场景

  1. 01研究 Azure 或 .NET 概念
  2. 02查找特定语言的代码示例
  3. 03查询 VS Code 或 GitHub 文档

MCP 相关

使用 Microsoft Learn MCP 查询 Learn 内容，并为托管在其他位置的文档指定其他 MCP 或 Context7 来源。也介绍了作为替代方案的 mslearn 命令行。

安装

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

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

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

详细介绍

Microsoft Docs

面向 Microsoft 技术生态的研究技能。涵盖 learn.microsoft.com 以及托管在其之外的文档（VS Code、GitHub、Aspire、Agent Framework 仓库）。

默认：Microsoft Learn MCP

对于 learn.microsoft.com 上的所有内容，请使用这些工具——Azure、.NET、M365、Power Platform、Agent Framework、Semantic Kernel、Windows 等。这是应对绝大多数 Microsoft 文档查询的主要工具。

工具用途
microsoft_docs_search搜索 learn.microsoft.com——概念、指南、教程、配置
microsoft_code_sample_search从 Learn 文档中查找可用的代码片段。传入 language（python、csharp 等）以获得最佳结果
microsoft_docs_fetch从特定 URL 获取完整页面内容（当搜索摘录不够用时）

当你需要完整教程、所有配置选项，或搜索摘录被截断时，请在搜索后使用 microsoft_docs_fetch。

CLI 替代方案

如果 Learn MCP 服务不可用，请改用终端或 shell（例如 Bash、PowerShell 或 cmd）中的 mslearn CLI：

# Run directly (no install needed)
npx @microsoft/learn-cli search "BlobClient UploadAsync Azure.Storage.Blobs"

# Or install globally, then run
npm install -g @microsoft/learn-cli
mslearn search "BlobClient UploadAsync Azure.Storage.Blobs"
MCP 工具CLI 命令
microsoft_docs_search(query: "...")mslearn search "..."
microsoft_code_sample_search(query: "...", language: "...")mslearn code-search "..." --language ...
microsoft_docs_fetch(url: "...")mslearn fetch "..."

向 search 或 code-search 传入 --json 可获得原始 JSON 输出以便进一步处理。

例外：何时使用其他工具

以下类别托管在 learn.microsoft.com 之外。请改用指定的工具。

.NET Aspire——使用 Aspire MCP 服务（首选）或 Context7

Aspire 文档位于 aspire.dev，而非 Learn。最佳工具取决于你的 Aspire CLI 版本：

CLI 13.2+（推荐）——Aspire MCP 服务包含内置的文档搜索工具：

MCP 工具描述
list_docs列出 aspire.dev 上所有可用的文档
search_docs对 aspire.dev 内容进行加权词法搜索
get_doc通过 slug 检索特定文档

这些工具随 Aspire CLI 13.2 一起发布（PR #14028）。更新方式：aspire update --self --channel daily。参考：https://davidpine.dev/posts/aspire-docs-mcp-tools/

CLI 13.1——MCP 服务提供集成查找（list_integrations、get_integration_docs），但不提供文档搜索。请回退到 Context7：

库 ID用途
/microsoft/aspire.dev首选——指南、集成、CLI 参考、部署
/dotnet/aspire运行时源码——API 内部实现、实现细节
/communitytoolkit/aspire社区集成——Go、Java、Node.js、Ollama
VS Code——使用 Context7

VS Code 文档位于 code.visualstudio.com，而非 Learn。

库 ID用途
/websites/code_visualstudio用户文档——设置、功能、调试、远程开发
/websites/code_visualstudio_api扩展 API——webview、TreeView、命令、贡献点
GitHub——使用 Context7

GitHub 文档位于 docs.github.com 和 cli.github.com。

库 ID用途
/websites/github_enActions、API、仓库、安全、管理、Copilot
/websites/cli_githubGitHub CLI（gh）命令和标志
Agent 框架 — 使用 Learn MCP + Context7

Agent 框架教程位于 learn.microsoft.com（使用 microsoft_docs_search），但 GitHub 仓库 中提供了 API 级别的细节，往往比已发布的文档更新 — 尤其是 DevUI REST API 参考、CLI 选项和 .NET 集成。

库 ID用途
/websites/learn_microsoft_en-us_agent-framework教程 — DevUI 指南、跟踪、工作流编排
/microsoft/agent-frameworkAPI 细节 — DevUI REST 端点、CLI 标志、认证、.NET AddDevUI/MapDevUI

DevUI 提示： 在 Learn 网站源中查询操作指南，然后在仓库源中查询 API 级别的具体细节（端点模式、代理配置、认证令牌）。

Context7 设置

对于任何 Context7 查询，首先解析库 ID（每个会话一次）：

  1. 使用技术名称调用 mcp_context7_resolve-library-id
  2. 使用返回的库 ID 和具体查询调用 mcp_context7_query-docs

编写有效的查询

要具体 — 包含版本、意图和语言：

# ❌ Too broad
"Azure Functions"
"agent framework"

# ✅ Specific
"Azure Functions Python v2 programming model"
"Cosmos DB partition key design best practices"
"GitHub Actions workflow_dispatch inputs matrix strategy"
"Aspire AddUvicornApp Python FastAPI integration"
"DevUI serve agents tracing OpenTelemetry directory discovery"
"Agent Framework workflow conditional edges branching handoff"

包含上下文：

  • 相关时包含版本（.NET 8、Aspire 13、VS Code 1.96）
  • 任务意图（quickstart、tutorial、overview、limits、API reference）
  • 多语言文档的语言（Python、TypeScript、C#）

评论

支持 Markdown