Azure MCP サーバー

🌟 Azure MCP サーバー

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

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

📑 目次

🎯 概要

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

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

🔍 Azure リソースを探索する

「Azure ストレージアカウントの一覧を表示する」
「すべての Cosmos DB データベースを表示」
「Azure AI Search サービス 'mysvc' にはどのようなインデックスがありますか?」
「リソースグループの一覧を表示」
「ストレージアカウント内のテーブルを表示してください」
「Cosmos DB データベース内のコンテナーを一覧表示する」
「ストレージコンテナの詳細を取得する」
「クラスター 'mycluster' 内の Kusto データベースを取得する」
「Kusto データベース 'db1' のテーブル 'StormEvents' から 10 行をサンプリングします」

📊 クエリと分析

「Log Analytics ワークスペースをクエリする」
「このインデックスで「検索クエリ」を検索してみましょう」

⚙️ 構成の管理

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

🔧 高度な Azure 操作

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

🔍 仕組み

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

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

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

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

🔎 Azure AI Search（検索エンジン/ベクターデータベース）

Azure AI Search サービスの一覧
インデックスを一覧表示し、そのスキーマと構成を確認します
クエリ検索インデックス

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

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

🐘 Azure Database for PostgreSQL - フレキシブルサーバー

データベースを一覧表示し、クエリを実行します。
テーブルのスキーマを一覧表示して取得します。
サーバーの一覧表示、構成の取得、およびパラメータの取得を行います。

🧮 Kusto (Azure データエクスプローラー)

Kusto クラスターの一覧表示
Kusto クラスター内のデータベースを一覧表示する
Kusto データベース内のテーブルを一覧表示する
Kusto テーブルのスキーマを取得する
Kusto テーブルのサンプル行
KQL を使用して Kusto データベースをクエリする

💾 Azure ストレージ

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

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

Log Analytics ワークスペースの一覧表示
KQL を使用してログをクエリする
利用可能なテーブルの一覧

⚙️ Azure アプリ構成

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

🔑 Azure キーボールト

キーの一覧表示、作成、取得

📦 Azure リソースグループ

リソースグループの一覧表示

🚌 Azure サービスバス

キュー、トピック、サブスクリプションに関するプロパティとランタイム情報を調べる

🔧 Azure CLI 拡張機能

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

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

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

エージェントとモデルは、 azd MCPツールのベストプラクティスと使用ガイドラインを発見し、学習できます。詳細については、 AZDベストプラクティスをご覧ください。

🛡️ Azure のベストプラクティス

効果的なコード生成のために、安全で運用レベルの Azure SDK ベストプラクティスを入手します。

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

🔌 はじめに

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

VS Code + GitHub コパイロット

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

前提条件

VS Code の安定版または Insiders リリースのいずれかをインストールします。
- 💫 安定版リリース
- 🔮 インサイダーリリース
GitHub CopilotとGitHub Copilot Chat拡張機能をインストールする
Node.js 20以降をインストールする
- nodeとnpmパスに含まれていることを確認する
空のフォルダで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"
      ]
    }
  }
}

Dockerのインストール

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

リポジトリのクローン
リポジトリのルートから、Docker イメージをビルドします: docker build -t azure/azuremcp .
EnvironmentCredentialセットのいずれかに一致する環境変数を含む.envファイルを作成します。例えば、サービスプリンシパルを使用する.envファイルは次のようになります。

AZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}
AZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}
AZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}

.vscode/mcp.jsonを追加するか、既存の MCP 設定を更新してください。/full/path/to/.env /full/path/to/.env``.envファイルへのパスに置き換えてください。

{
  "servers": {
    "Azure MCP Server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "azure/azuremcp",
        "--env-file",
        "/full/path/to/.env"
      ]
    }
  }
}

オプションで、顧客は--envまたは--volumeを使用して認証値を渡すことができます。

🧪 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 サーバーはそれらの資格情報を自動的に使用します。RBAC (ロールベースのアクセス制御) を介して、Azure で適切な承認権限 (例: ストレージアカウントへの読み取りアクセス) があることを確認してください。Azure の RBAC 承認システムの詳細については、こちらのリンクをご覧ください。

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

制作資格

デフォルトでは、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までお問い合わせください。

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.