Azure MCP

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

モデルコンテキストプロトコル（MCP）の実装で、Claude DesktopがAzureサービスと相互作用できるようにします。この統合により、Claudeは自然言語対話を通じて直接Azureリソースを照会および管理できます。

✨ 主な機能

• Azureリソース管理：Azureリソース管理クライアントインターフェイスとの連携
• サブスクリプション管理：Azureサブスクリプションの一覧表示と管理
• テナント管理：Azureテナントの一覧表示と選択
• 自動認証：DefaultAzureCredentialを利用した柔軟な認証方法
• エラー処理：リトライ機能を備えた堅牢なエラー処理
• クリーンな応答形式：Claude Desktopと互換性のある正しくフォーマットされた応答

📦 インストール

手動インストール

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"
      ]
    }
  }
}

🔐 認証

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

• 環境変数
• 管理 ID
• Azure CLI
• Visual Studio Code
• インタラクティブブラウザ

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

💻 使用例

基本的な使用法

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

サンプル対話

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

🔧 技術詳細

プロジェクト構造

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：“select-tenant”ツールを使用してテナントを選択してください。
   • NO_CLIENTS：正しい初期化と認証が行われていることを確認してください。
   • CODE_EXECUTION_FAILED：Azureの権限と接続を確認してください。

🤝 コントリビューション

コントリビューションを歓迎します！ 自由にプルリクエストを送信してください。

👥 コントリビューター

• @calclavia - smithery.aiとの統合

🙏 謝辞

• Claude Desktopチーム - MCPの実装
• Azure SDKチーム - 包括的なSDK
• Microsoft Azureサービス - サポート

📄 ライセンス

[ここにライセンス情報を追加してください。例：MIT Licenseまたはその他の適用可能なライセンス]