🌟 Azure MCP サーバー

Azure MCP サーバーはMCP 仕様を実装し、AI エージェントと Azure Storage、Cosmos DB などの主要な Azure サービス間のシームレスな接続を作成します。

このプロジェクトはパブリックプレビュー段階であり、一般公開前に実装が大幅に変更される可能性があることにご注意ください。

🎯 概要

✨ Azure MCP サーバーで何ができるでしょうか?

Azure MCP サーバーは、Azure コンテキストを活用してエージェントを強化します。以下に、試してみる価値のある便利なプロンプトをいくつかご紹介します。

🔍 Azure リソースを探索する

「Azure ストレージアカウントの一覧を表示する」
「すべての Cosmos DB データベースを表示」
「リソースグループの一覧を表示」
「ストレージアカウント内のテーブルを表示してください」
「Cosmos DB データベース内のコンテナーを一覧表示する」
「ストレージコンテナの詳細を取得する」

📊 クエリと分析

「Log Analytics ワークスペースをクエリする」

⚙️ 構成の管理

「App Configuration ストアの一覧を表示」
「App Config でキーと値のペアを表示する」

🔧 高度な Azure 操作

「Azure CDN エンドポイントの一覧を表示する」
「Node.js を使用して Azure アプリケーションを構築するのを手伝ってください」

🔍 仕組み

Azure MCP サーバーは、次の機能を通じて AI エージェントと Azure サービス間のシームレスな統合を実現します。

🔄 AIエージェントが理解できるスマートなJSON通信
🏗️ Azure 操作に翻訳される自然言語コマンド
💡 インテリジェントなパラメータ提案と自動補完
⚡ 意味のある一貫したエラー処理

🛠️ 現在サポートされているツール

Azure MCP サーバーは、次の Azure サービスと対話するためのツールを提供します。

📊 Azure Cosmos DB (NoSQL データベース)

Cosmos DB アカウントの一覧表示
データベースの一覧表示とクエリ
コンテナとアイテムを管理する
コンテナに対してSQLクエリを実行する

💾 Azure ストレージ

ストレージアカウントの一覧表示
BLOB コンテナーと BLOB を管理する
ストレージテーブルの一覧表示とクエリ
コンテナのプロパティとメタデータを取得する

📈 Azure モニター (ログ分析)

Log Analytics ワークスペースの一覧表示
KQL を使用してログをクエリする
利用可能なテーブルの一覧
監視オプションを構成する

⚙️ Azure アプリ構成

アプリ構成ストアの一覧
キーと値のペアを管理する
ラベル付き構成を処理する
構成設定のロック/ロック解除

📦 Azure リソースグループ

リソースグループの一覧表示
リソースグループ管理操作

🔧 Azure CLI 拡張機能

Azure CLI コマンドを直接実行する
すべての Azure CLI 機能のサポート
JSON出力フォーマット
クロスプラットフォームの互換性

🚀 Azure 開発者 CLI (azd) 拡張機能

Azure Developer CLI コマンドを直接実行する
テンプレートの検出、テンプレートの初期化、プロビジョニング、およびデプロイメントのサポート
クロスプラットフォームの互換性

詳細なコマンドのドキュメントと例については、「Azure MCP コマンド」を参照してください。

🔌 はじめに

Azure MCP サーバーのインストールと実行には Node.js が必要です。インストールされていない場合は、こちらの手順に従ってください。

VS Code + GitHub コパイロット

Azure MCP Server は、Azure データプレーンツールを提供します。単独で使用することも、VS Code のGitHub Copilot for Azure 拡張機能と併用することもできます。Microsoft Learn でのドキュメント検索など、Azure MCP Server に含まれていないさまざまな Azure 開発シナリオにわたる幅広い開発者サポートにご興味がある場合は、この拡張機能もお勧めします。

前提条件

VS Code の安定版または Insiders リリースのいずれかをインストールします。
- 💫 安定版リリース
- 🔮 インサイダーリリース
GitHub CopilotとGitHub Copilot Chat拡張機能をインストールする
空のフォルダでVS Codeを開く

インストール

✨ ワンクリックインストール

これらのボタンのいずれかをクリックして、VS Code または VS Code Insiders 用の Azure MCP サーバーをインストールします。

Azure MCP Server をインストールしたら、GitHub Copilot エージェントモードを選択し、ツールリストを更新してください。エージェントモードの詳細については、 VS Code ドキュメントをご覧ください。

🔧 手動インストール

ステップバイステップのインストールについては、次の手順に従ってください。

.vscode/mcp.jsonを追加します:

{
  "servers": {
    "Azure MCP Server": {
      "command": "npx",
      "args": [
        "-y",
        "@azure/mcp@latest",
        "server",
        "start"
      ]
    }
  }
}

🧪 Azure MCP サーバーをテストする

VS CodeでGitHub Copilotを開き、エージェントモードに切り替えます。
ツールの一覧にAzure MCP Serverが表示されます。
「Azure Storage コンテナーの一覧を表示する」など、エージェントに Azure MCP サーバーを使用するように指示するプロンプトを試してください。
エージェントはAzure MCP Serverツールを使用してクエリを完了できる必要があります

🤖 カスタム MCP クライアント

MCPクライアントをAzure MCPサーバーを使用するように簡単に構成できます。クライアントで以下のコマンドを実行し、標準IOまたはSSE経由でアクセスしてください。

標準IOの使用

MCPクライアントをnpx -y @azure/mcp@latest server startを実行するように構成します。VS Codeの使用方法については、「ワンクリックインストール」または「手動インストール」の手順に従ってください。

SSEの使用

ターミナルウィンドウを開き、次のコマンドを実行します: npx -y @azure/mcp@latest server start --transport sse
サーバーが起動し、 http://localhost:5008でホストされます。別のポートを使用する場合は、 --port {YOUR-PORT-NUMBER}を追加してください。
MCPクライアントを開き、SSE設定値を追加します。MCPクライアントによって異なる場合があります。VS Codeでは、以下のようになります。
{ "servers": { "Azure MCP Server": { "type": "sse", "url": "http://localhost:5008/sse" } } }

エンドツーエンドの MCP クライアント/エージェントガイドが近日中に公開される予定です。

📝 トラブルシューティング

一般的な問題とログ記録に関するヘルプについては、トラブルシューティングガイドを参照してください。

🔑 認証

Azure MCP サーバーは、ホストオペレーティングシステムの認証メカニズムとシームレスに統合されるため、導入が非常に簡単です。Azure Identity はDefaultAzureCredentialを介して内部的に使用され、以下の資格情報が順に試行されます。

環境変数（ EnvironmentCredential ） - CI/CDパイプラインに最適
共有トークンキャッシュ（ SharedTokenCacheCredential ） - 他のツールからキャッシュされたトークンを使用します
Visual Studio ( VisualStudioCredential ) - Visual Studio の資格情報を使用します
Azure CLI ( AzureCliCredential ) - 既存のAzure CLIログインを使用します
Azure PowerShell ( AzurePowerShellCredential ) - Az PowerShell ログインを使用します
Azure Developer CLI ( AzureDeveloperCliCredential ) - azdログインを使用します
インタラクティブブラウザ( InteractiveBrowserCredential ) - 必要に応じてブラウザベースのログインにフォールバックします

これらのいずれかの方法で既にログインしている場合は、Azure MCP サーバーは自動的にそれらの資格情報を使用します。

認証で問題が発生した場合は、トラブルシューティングガイドをご覧ください。

制作資格

デフォルトでは、Azure MCP サーバーはマネージド ID やワークロード ID などの運用環境の資格情報を除外します。これらの資格情報を有効にするには、環境変数を設定します。

AZURE_MCP_INCLUDE_PRODUCTION_CREDENTIALS=true

これは、マネージド ID を使用する Azure サービスで実行する場合に役立ちます。

🛡️ セキュリティに関する注意事項

資格情報は常に公式のAzure Identity SDKを通じて安全に処理されます。トークンを直接保存したり管理したりすることはありません。

MCPという現象は非常に斬新で最先端です。他の新しい技術標準と同様に、MCPサーバーと統合するすべてのシステムが、システムが遵守すべきすべての規制と標準に準拠していることを確認するために、セキュリティレビューの実施を検討してください。これには、Azure MCPサーバーだけでなく、実装するすべてのMCPクライアント/エージェント、そしてモデルプロバイダーも含まれます。

👥 貢献する

Azure MCP サーバーへの貢献を歓迎します。バグの修正、新機能の追加、ドキュメントの改善など、どのような貢献でも歓迎します。

以下のガイドラインについては、貢献ガイドをお読みください。

🛠️ 開発環境の設定
✨ 新しいコマンドの追加
📝 コードスタイルとテスト要件
🔄 プルリクエストの作成

🤝 行動規範

このプロジェクトは、Microsoft オープンソース行動規範を採用しています。詳細については、行動規範に関する FAQ をご覧ください。ご質問やご意見がございましたら、 opencode@microsoft.comまでお問い合わせください。

Integrations