Azure Resource Management

🚀 Azure MCP（モデルコンテキストプロトコル） for Claude Desktop

Azure MCPは、Claude DesktopがAzureサービスとやり取りできるようにするModel Context Protocol (MCP) の実装です。この統合により、Claudeは自然言語対話を通じて直接Azureリソースを照会および管理できます。

✨ 主な機能

• Azureリソース管理：Azure Resource Managementクライアントインターフェースとの連携
• サブスクリプション管理：Azureサブスクリプションの一覧表示と管理
• テナント管理：Azureテナントの一覧表示と選択
• 自動認証：DefaultAzureCredentialを利用した柔軟な認証方法
• エラー処理：一時的な障害に対するリトライメカニズム
• クリーンな応答形式：Claude Desktopと互換性のある適切な形式の応答

📦 インストール

前提条件

• Node.js（v18以上）
• Claude Desktopアプリケーション
• 適切な権限を持つAzureアカウント
• Azure CLI（CLIベースの認証に必要な場合はオプション）

手動インストール

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

git clone https://github.com/Streen9/azure-mcp.git
cd azure-mcp

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

npm install

3. Claude Desktopを設定します：
   • 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"
      ]
    }
  }
}

💻 使用例

基本的な使用法

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

チャットの例

あなた：すべての利用可能なAzureアカウントとサブスクリプションを取得できますか？
Claude：すべての利用可能なAzureテナントとサブスクリプションをリストするのを手伝います。
[ClaudeはAzure MCPを使用して情報を取得し、表示します]

高度な使用法

あなた：/azure/list_accounts
Claude：あなたのAzureアカウントとサブスクリプション情報を取得中...
完了！以下は利用可能なサブスクリプションのリストです：
- サブスクリプション 1: ID: sub-12345678, 名前: Production
- サブスクリプション 2: ID: sub-abcdefgh, 名前: Development

これらのサブスクリプションIDを使用して他の操作を続けることができます。

🔧 技術詳細

認証

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

• 環境変数
• マネージドID
• Azure CLI
• Visual Studio Code
• ブラウザーの対話型認証

サーバーはこれらの方法を順番に試行し、1つが成功するまで続けます。

プロジェクト構造

azure-mcp/
├── src/
│   ├── launcher.ts       # サーバーのエントリーポイント
│   ├── AzureServer.ts    # 主要なMCPサーバーの実装
│   └── LoggerService.ts  # ログユーティリティ
├── package.json
└── README.md

主要コンポーネント

• AzureMCPServer：主要なMCPサーバークラス
• HandleCallTool：受信したツールリクエストを処理
• ExecuteWithRetry：操作の弾力性を高めるためのリトライロジックを実装

トラブルシューティング

1. 認証問題：
   • Azure CLIを使用してログインしていることを確認します（az login）。
   • サービスプリンシパルの環境変数を確認します。
   • あなたのAzureアカウントが必要な権限を持っていることを検証します。
2. 接続問題：
   • Claude Desktopが正しく構成されていることを確認します。
   • 構成ファイルのパスがインストール場所と一致することを確認します。
   • 他のインスタンスが実行中でないことを確認します。
3. 一般的なエラー：
   • NO_TENANT：'選択テナント'ツールを使用してテナントを選択します。
   • NO_CLIENTS：初期化と認証が正しく行われていることを確認します。
   • CODE_EXECUTION_FAILED：Azureの権限と接続を確認します。

貢献

貢献を歓迎します！自由にPull Requestを送信してください。

貢献者

• @calclavia - smithery.aiとの統合

謝辞

以下のチームに感謝します：

• Claude DesktopチームのMCP実装
• Azure SDKチームの包括的なSDK
• Model Context ProtocolによるAIサービスの統合の実現

📄 ライセンス

この実装はセキュリティのベストプラクティスに従っています：

• 入力検証：すべてのユーザー提供データが適切に検証されます。
• 最小限の権限：認証と承認に制限付きの資格情報を使用します。
• ログ記録と監視：潜在的な問題を検出するために詳細なログ記録と継続的な監視を実施します。

連絡先

連絡するには、プロジェクトのホームページにアクセスするか、GitHubで問題を送信してください。

注意：このドキュメントは例です。実際の内容は異なる場合があります。正確な情報については、公式ドキュメントを参照してください。