Claude デスクトップ用の Azure MCP (モデル コンテキスト プロトコル)
Claude Desktop が Azure サービスと連携できるようにするモデルコンテキストプロトコル (MCP) 実装。この統合により、Claude は自然言語による会話を通じて Azure リソースを直接クエリおよび管理できるようになります。
特徴
Azure リソース管理: Azure リソース管理クライアントとのインターフェイス
サブスクリプション管理: Azure サブスクリプションの一覧表示と管理
テナント管理: Azure テナントの一覧表示と選択
自動認証: DefaultAzureCredential を活用して柔軟な認証方法を実現します
エラー処理: 一時的な障害に対する再試行を含む堅牢なエラー処理
クリーンなレスポンスフォーマット: Claude Desktopと互換性のある適切にフォーマットされたレスポンス
Related MCP server: Azure AI Search MCP Server
前提条件
Node.js (v18以上)
クロードデスクトップアプリケーション
適切な権限を持つ Azure アカウント
Azure CLI (オプション、CLI ベースの認証用)
インストール
手動インストール
リポジトリをクローンします。
git clone https://github.com/Streen9/azure-mcp.git
cd azure-mcp依存関係をインストールします:
npm installClaude デスクトップを設定します。
claude_desktop_config.jsonを開く次の MCP 構成を追加します。
{
"mcpServers": {
"sequential-thinking": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-sequential-thinking"
]
},
"azure": {
"command": "tsx",
"args": [
"C:/Users/[YourUsername]/path/to/azure-mcp/src/launcher.ts"
]
}
}
}認証
サーバーは、DefaultAzureCredential を通じて複数の認証方法をサポートします。
環境変数
マネージドID
Azure CLI
ビジュアルスタジオコード
インタラクティブブラウザ
サーバーは、いずれかの方法が成功するまで、これらの方法を自動的に順番に試します。
使用法
Claude Desktop が実行中の場合は閉じます(タスク マネージャーを確認してください)。
Claudeデスクトップを起動
チャットでは、次のような Azure 関連の質問をすることができます。
「利用可能なすべての Azure アカウントとサブスクリプションを取得できますか?」
「サブスクリプション内のすべてのリソース グループを一覧表示する」
「特定のリソース グループ内のすべての仮想マシンを表示する」
会話例
You: Can you get all the available Azure accounts and subscriptions?
Claude: I'll help you list all available Azure tenants and subscriptions.
[Claude will then use the Azure MCP to fetch and display the information]発達
プロジェクト構造
azure-mcp/
├── src/
│ ├── launcher.ts # Server entry point
│ ├── AzureServer.ts # Main MCP server implementation
│ └── LoggerService.ts # Logging utility
├── package.json
└── README.md主要コンポーネント
AzureMCPServer : MCP プロトコルを実装するメイン サーバー クラス
HandleCallTool : 受信したツール要求を処理する
ExecuteWithRetry : 回復力のある操作のための再試行ロジックを実装します
トラブルシューティング
認証の問題:
Azure CLI (
az login) 経由でログインしていることを確認します。サービスプリンシパルを使用している場合は環境変数を確認してください
Azureアカウントに必要な権限があることを確認する
接続の問題:
Claude Desktop の構成を確認する
設定ファイル内のパスがインストールと一致していることを確認してください
他のインスタンスが実行されていないことを確認する
よくあるエラー:
NO_TENANT: 「select-tenant」ツールを使用してテナントを選択しますNO_CLIENTS: 適切な初期化と認証を保証するCODE_EXECUTION_FAILED: Azureの権限と接続を確認してください
貢献
貢献を歓迎します!お気軽にプルリクエストを送信してください。
寄稿者
@calclavia - smithery.ai との統合
謝辞
MCP実装のClaude Desktopチーム
包括的な SDK を提供する Azure SDK チーム
AIサービス統合を可能にするモデルコンテキストプロトコル
セキュリティに関する注意事項
この実装は、Azure セキュリティのベスト プラクティスに従います。
ハードコードされた資格情報はありません
安全な認証チェーンの実装
適切なエラー処理とサニタイズ
セキュリティ上の懸念や脆弱性については、問題を作成してください。