mcpField
M
microsoft-code-reference

microsoft-code-reference

github.com/github開発40.5k14.3k 回インストール1 日前に更新
リポジトリ

microsoft-code-reference について

SDK コードの作成やトラブルシューティングに先立ち、Microsoft API の詳細を確認し、公式コードサンプルを探すスキルです。Microsoft Learn の検索・取得ツールを使い、代替として mslearn コマンドラインも案内します。

主な機能

  1. 01API メソッドとクラスの検索
  2. 02公式コードサンプルの検索
  3. 03API リファレンス全文の取得
  4. 04SDK エラーのトラブルシューティング
  5. 05パッケージ、シグネチャ、バージョンの確認
  6. 06代替手段として mslearn コマンドラインを使用

活用シーン

  1. 01コーディング前の SDK メソッド確認
  2. 02Azure タスクのサンプル探し
  3. 03コードと動作する例の照合
  4. 04認証や API エラーの調査

MCP 対応

Microsoft Learn MCP ツールでドキュメント検索、コードサンプル検索、ページ取得を行います。Learn MCP サーバーが利用できない場合は、同等の操作に mslearn コマンドラインを使う方法を示します。

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/microsoft-code-referenceを入力して読み込まれたか確認します。

詳細

Microsoft コードリファレンス

ツール

目的ツール例
API メソッド/クラスの検索microsoft_docs_search"BlobClient UploadAsync Azure.Storage.Blobs"
動作するコードサンプルmicrosoft_code_sample_searchquery: "upload blob managed identity", language: "python"
完全な API リファレンスmicrosoft_docs_fetchmicrosoft_docs_search から URL を取得する（オーバーロード、完全なシグネチャ向け）

コードサンプルの検索

microsoft_code_sample_search を使用して、公式の動作する例を取得します:

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")

使用する場面:

  • コードを書く前—従うべき動作するパターンを見つける
  • エラー発生後—自分のコードを既知の正常なサンプルと比較する
  • 初期化/セットアップが不明なとき—サンプルには完全なコンテキストが示されています

API の検索

# 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"

メソッドに複数のオーバーロードがある場合や、完全なパラメーターの詳細が必要な場合は、ページ全体を取得してください。

エラーのトラブルシューティング

microsoft_code_sample_search を使用して動作するコードサンプルを見つけ、自分の実装と比較してください。特定のエラーについては、microsoft_docs_search と microsoft_docs_fetch を使用します:

エラーの種類クエリ
メソッドが見つからない"[ClassName] methods [Namespace]"
型が見つからない"[TypeName] NuGet package namespace"
シグネチャが正しくない"[ClassName] [MethodName] overloads" → ページ全体を取得
非推奨の警告"[OldType] migration v12"
認証の失敗"DefaultAzureCredential troubleshooting"
403 Forbidden"[ServiceName] RBAC permissions"

確認すべき場面

次の場合は必ず確認してください:

  • メソッド名が「都合がよすぎる」ように見える場合（UploadFile と実際の Upload など）
  • SDK のバージョンが混在している場合（v11 の CloudBlobClient と v12 の BlobServiceClient）
  • パッケージ名が慣例に従っていない場合（.NET では Azure.*、Python では azure-*）
  • API を初めて使用する場合

検証ワークフロー

Microsoft SDK を使用したコードを生成する前に、それが正しいことを検証してください:

  1. メソッドまたはパッケージが存在することを確認する — microsoft_docs_search(query: "[ClassName] [MethodName] [Namespace]")
  2. 完全な詳細を取得する（オーバーロード/複雑なパラメーターの場合） — microsoft_docs_fetch(url: "...")
  3. 動作するサンプルを見つける — microsoft_code_sample_search(query: "[task]", language: "[lang]")

単純な検索では、手順 1 だけで十分な場合があります。複雑な API の使用では、3 つの手順をすべて完了してください。

CLI による代替手段

Learn MCP サーバーが利用できない場合は、代わりにターミナルまたはシェル（たとえば 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 出力を取得できます。

コメント

Markdown 対応