Azure MCP

🚀 Azure Omni-Tool MCP Server

モデルコンテキストプロトコル (MCP) サーバー は、TypeScriptで構築され、自然言語リクエストとAzure CLIの実行の間のインテリジェントなブリッジとして機能します。

✨ 主な機能

✅ 計画/実行フロー - コマンドを実行する前にレビュー
✅ セキュリティガードレール - シェルインジェクション検出、破壊的なコマンドの警告
✅ 監査トレイル - トレーサビリティのためのオペレーターのメールタグ付け
✅ リトライロジック - 一時的な障害に対する指数バックオフ
✅ キャッシング - TTLを設定可能なLRUキャッシュ
✅ テナントスコーピング - 環境を介してテナント/サブスクリプションを構成
✅ Azureサービスアダプター - 8つのAzureサービスへの型安全なアクセス

📚 アーキテクチャ概要

flowchart TB
    subgraph Client["🖥️ クライアント層"]
        LLM[LLM / AIエージェント]
    end

    subgraph MCP["⚙️ MCPサーバー"]
        direction TB
        Entry[index.ts]
        
        subgraph Tools["ツール"]
            T1[manage_azure_resources]
            T2[get_azure_context]
            T3[azure_service]
        end
        
        subgraph Lib["コアライブラリ"]
            Auth[auth.ts]
            Cache[cache.ts]
            CLI[cli-executor.ts]
            Retry[retry.ts]
            Safety[safety.ts]
            Audit[audit.ts]
        end
        
        subgraph Services["サービスアダプター"]
            S1[StorageService]
            S2[CosmosService]
            S3[SearchService]
            S4[KustoService]
            S5[MonitorService]
            S6[AppConfigService]
            S7[KeyVaultService]
            S8[PostgresService]
        end
    end

    subgraph Azure["☁️ Azure"]
        AzCLI[Azure CLI]
        AzAPI[Azure API]
    end

    LLM -->|MCPプロトコル| Entry
    Entry --> Tools
    Tools --> Lib
    Tools --> Services
    Services --> Lib
    Lib --> AzCLI
    Auth --> AzAPI

📋 リクエストフロー

sequenceDiagram
    participant C as クライアント
    participant M as MCPサーバー
    participant S as セキュリティ
    participant E as CLIエグゼキューター
    participant A as Azure

    C->>M: ツールリクエスト
    M->>S: 入力の検証
    alt 不安全なコマンド
        S-->>M: ブロック + 警告
        M-->>C: エラーレスポンス
    else 安全
        S-->>M: 承認
        M->>E: コマンドの実行
        E->>A: az CLI呼び出し
        A-->>E: レスポンス
        E-->>M: 結果 + 解析
        M-->>C: 構造化された出力
    end

📋 計画/実行フロー

flowchart LR
    A[LLMクライアント] -->|自然言語| B[MCPサーバー]
    B --> C{すぐに実行?}
    C -->|false| D[計画の返却]
    C -->|true| E[CLIの実行]
    E --> F{成功?}
    F -->|Yes| G[出力の返却]
    F -->|No| H[エラー + 分析の返却]
    H -->|フィードバックループ| A

🚀 クイックスタート

1. 依存関係のインストール

npm install

2. 環境の構成

cp .env.example .env
# .envを自分の設定で編集

3. ビルドと実行

npm run build
npm start

MCPクライアントの構成

{
  "mcpServers": {
    "azure-omni-tool": {
      "command": "node",
      "args": ["path/to/Azure-mcp/dist/index.js"]
    }
  }
}

💻 使用例

manage_azure_resources

セキュリティチェックを伴うAzure CLIコマンドの計画と実行。

get_azure_context

キャッシングを利用したAzure環境のクエリ。

azure_service

特定のAzureサービスとのやり取り。

📄 環境変数

📁 プロジェクト構造

Azure-mcp/
├── src/
│   ├── index.ts                 # MCPサーバーのエントリーポイント
│   ├── lib/
│   │   ├── auth.ts              # Azure資格情報の管理
│   │   ├── audit.ts             # 相関IDを持つ監査トレイル
│   │   ├── cache.ts             # TTL付きのLRUキャッシュ
│   │   ├── cli-executor.ts      # Azure CLIのラッパー
│   │   ├── config.ts            # 環境構成
│   │   ├── logger.ts            # 構造化JSONログ
│   │   ├── retry.ts             # 指数バックオフ
│   │   ├── safety.ts            # 入力のサニタイズ
│   │   └── types.ts             # 共有型
│   ├── services/
│   │   ├── base-service.ts      # 抽象サービスベース
│   │   ├── storage.ts           # Azure Storage
│   │   ├── cosmos.ts            # Cosmos DB
│   │   ├── search.ts            # AI Search
│   │   ├── kusto.ts             # データエクスプローラー
│   │   ├── monitor.ts           # モニタリング / ログ分析
│   │   ├── appconfig.ts         # アプリケーション構成
│   │   ├── keyvault.ts          # キーコンテナ
│   │   ├── postgres.ts          # PostgreSQLフレキシブルサーバー
│   │   └── index.ts             # サービスファクトリー
│   └── tools/
│       ├── azure-manager.ts     # 計画/実行ツール
│       ├── context-retriever.ts # コンテキストクエリ
│       └── service-tool.ts      # サービスアダプターツール
├── .env.example
├── package.json
└── tsconfig.json

📋 前提条件

• Node.js >= 18.0.0
• Azure CLIがインストールされ、認証済み (az login)

📄 ライセンス

MIT