Agent Skills › MicrosoftDocs/mcp › microsoft-code-reference

microsoft-code-reference

GitHub

提供微软SDK及API的代码参考、签名验证与错误修复。通过官方文档搜索工作示例，识别幻觉方法、错误签名和过时模式，辅助编写、调试或审查涉及微软生态的代码。

skills/microsoft-code-reference/SKILL.md MicrosoftDocs/mcp

Trigger Scenarios

需要查找微软SDK或Azure API的正确用法遇到微软相关的代码编译错误或运行时异常验证API方法是否存在及参数签名是否正确

Install

npx skills add MicrosoftDocs/mcp --skill microsoft-code-reference -g -y

More Options

Use without installing

npx skills use MicrosoftDocs/mcp@microsoft-code-reference

指定 Agent (Claude Code)

npx skills add MicrosoftDocs/mcp --skill microsoft-code-reference -a claude-code -g -y

安装 repo 全部 skill

npx skills add MicrosoftDocs/mcp --all -g -y

预览 repo 内 skill

npx skills add MicrosoftDocs/mcp --list

SKILL.md

Frontmatter

{
    "name": "microsoft-code-reference",
    "context": "fork",
    "description": "Find working code samples, verify API signatures, and fix Microsoft SDK errors using official docs. Use whenever the user is writing, debugging, or reviewing code that touches any Microsoft SDK, .NET library, Azure client library, or Microsoft API—even if they don't ask for a \"reference.\" Catches hallucinated methods, wrong signatures, and deprecated patterns. If the task involves producing or fixing Microsoft-related code, this is the right skill.",
    "compatibility": "Primarily uses the Microsoft Learn MCP Server (https:\/\/learn.microsoft.com\/api\/mcp); if that is unavailable, fall back to the mslearn CLI (`npx @microsoft\/learn-cli`)."
}

Microsoft Code Reference

Tools

Need	Tool	Example
API method/class lookup	`microsoft_docs_search`	`"BlobClient UploadAsync Azure.Storage.Blobs"`
Working code sample	`microsoft_code_sample_search`	`query: "upload blob managed identity", language: "python"`
Full API reference	`microsoft_docs_fetch`	Fetch URL from `microsoft_docs_search` (for overloads, full signatures)

Finding Code Samples

Use microsoft_code_sample_search to get official, working examples:

microsoft_code_sample_search(query: "upload file to blob storage", language: "csharp")
microsoft_code_sample_search(query: "authenticate with managed identity", language: "python")
microsoft_code_sample_search(query: "send message service bus", language: "javascript")

When to use:

Before writing code—find a working pattern to follow
After errors—compare your code against a known-good sample
Unsure of initialization/setup—samples show complete context

API Lookups

# Verify method exists (include namespace for precision)
"BlobClient UploadAsync Azure.Storage.Blobs"
"GraphServiceClient Users Microsoft.Graph"

# Find class/interface
"DefaultAzureCredential class Azure.Identity"

# Find correct package
"Azure Blob Storage NuGet package"
"azure-storage-blob pip package"

Fetch full page when method has multiple overloads or you need complete parameter details.

Error Troubleshooting

Use microsoft_code_sample_search to find working code samples and compare with your implementation. For specific errors, use microsoft_docs_search and microsoft_docs_fetch:

Error Type	Query
Method not found	`"[ClassName] methods [Namespace]"`
Type not found	`"[TypeName] NuGet package namespace"`
Wrong signature	`"[ClassName] [MethodName] overloads"` → fetch full page
Deprecated warning	`"[OldType] migration v12"`
Auth failure	`"DefaultAzureCredential troubleshooting"`
403 Forbidden	`"[ServiceName] RBAC permissions"`

When to Verify

Always verify when:

Method name seems "too convenient" (UploadFile vs actual Upload)
Mixing SDK versions (v11 CloudBlobClient vs v12 BlobServiceClient)
Package name doesn't follow conventions (Azure.* for .NET, azure-* for Python)
Using an API for the first time

Validation Workflow

Before generating code using Microsoft SDKs, verify it's correct:

Confirm method or package exists — microsoft_docs_search(query: "[ClassName] [MethodName] [Namespace]")
Fetch full details (for overloads/complex params) — microsoft_docs_fetch(url: "...")
Find working sample — microsoft_code_sample_search(query: "[task]", language: "[lang]")

For simple lookups, step 1 alone may suffice. For complex API usage, complete all three steps.

CLI Alternative

If the Learn MCP server is not available, use the mslearn CLI from the command line instead:

# 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 Tool	CLI Command
`microsoft_docs_search(query: "...")`	`mslearn search "..."`
`microsoft_code_sample_search(query: "...", language: "...")`	`mslearn code-search "..." --language ...`
`microsoft_docs_fetch(url: "...")`	`mslearn fetch "..."`