Claude デスクトップ用の Azure MCP (モデル コンテキスト プロトコル)

Claude Desktop が Azure サービスと連携できるようにするモデルコンテキストプロトコル (MCP) 実装。この統合により、Claude は自然言語による会話を通じて Azure リソースを直接クエリおよび管理できるようになります。

特徴

• Azure リソース管理: Azure リソース管理クライアントとのインターフェイス
• サブスクリプション管理: Azure サブスクリプションの一覧表示と管理
• テナント管理: Azure テナントの一覧表示と選択
• 自動認証: DefaultAzureCredential を活用して柔軟な認証方法を実現します
• エラー処理: 一時的な障害に対する再試行を含む堅牢なエラー処理
• クリーンなレスポンスフォーマット: Claude Desktopと互換性のある適切にフォーマットされたレスポンス

前提条件

• Node.js (v18以上)
• クロードデスクトップアプリケーション
• 適切な権限を持つ Azure アカウント
• Azure CLI (オプション、CLI ベースの認証用)

インストール

手動インストール

1. リポジトリをクローンします。

2. 依存関係をインストールします:

3. Claude デスクトップを設定します。
   • claude_desktop_config.jsonを開く
   • 次の MCP 構成を追加します。

認証

サーバーは、DefaultAzureCredential を通じて複数の認証方法をサポートします。

• 環境変数
• マネージドID
• Azure CLI
• ビジュアルスタジオコード
• インタラクティブブラウザ

サーバーは、いずれかの方法が成功するまで、これらの方法を自動的に順番に試します。

使用法

1. Claude Desktop が実行中の場合は閉じます（タスク マネージャーを確認してください）。
2. Claudeデスクトップを起動
3. チャットでは、次のような Azure 関連の質問をすることができます。
   • 「利用可能なすべての Azure アカウントとサブスクリプションを取得できますか?」
   • 「サブスクリプション内のすべてのリソース グループを一覧表示する」
   • 「特定のリソース グループ内のすべての仮想マシンを表示する」

会話例

発達

プロジェクト構造

主要コンポーネント

• AzureMCPServer : MCP プロトコルを実装するメイン サーバー クラス
• HandleCallTool : 受信したツール要求を処理する
• ExecuteWithRetry : 回復力のある操作のための再試行ロジックを実装します

トラブルシューティング

1. 認証の問題:
   • Azure CLI ( az login ) 経由でログインしていることを確認します。
   • サービスプリンシパルを使用している場合は環境変数を確認してください
   • Azureアカウントに必要な権限があることを確認する
2. 接続の問題:
   • Claude Desktop の構成を確認する
   • 設定ファイル内のパスがインストールと一致していることを確認してください
   • 他のインスタンスが実行されていないことを確認する
3. よくあるエラー:
   • NO_TENANT : 「select-tenant」ツールを使用してテナントを選択します
   • NO_CLIENTS : 適切な初期化と認証を保証する
   • CODE_EXECUTION_FAILED : Azureの権限と接続を確認してください

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

寄稿者

• @calclavia - smithery.ai との統合

謝辞

• MCP実装のClaude Desktopチーム
• 包括的な SDK を提供する Azure SDK チーム
• AIサービス統合を可能にするモデルコンテキストプロトコル

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

この実装は、Azure セキュリティのベスト プラクティスに従います。

• ハードコードされた資格情報はありません
• 安全な認証チェーンの実装
• 適切なエラー処理とサニタイズ

セキュリティ上の懸念や脆弱性については、問題を作成してください。