Azure Data Explorer MCP Server

Azure Data Explorer MCP サーバー

Azure Data Explorer にログインして、KQL クエリを実行できる Model Context Protocol（MCP）サーバーです。

機能

• サービスプリンシパル（クライアント資格情報）を使用して Azure Data Explorer にログインします
• Azure Data Explorer データベースに対して KQL クエリを実行します
• フォーマットされたクエリ結果を表示します

前提条件

• Node.js（v16 以降）
• npm（v7 以降）
• Azure Data Explorer クラスター
• Azure Data Explorer へのアクセス権を持つサービスプリンシパル

セットアップ

1. このリポジトリをクローンまたはダウンロードします
2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

サーバーの実行

サーバーを起動します：

npm start

サーバーは標準入力／出力（stdio）で待ち受けます。これは Claude for Desktop のような MCP クライアントが想定する形式です。

Claude for Desktop での使用方法

1. claude_desktop_config.json ファイルを編集して、この MCP サーバーを使用するよう Claude for Desktop を設定します：

{
  "mcpServers": {
    "adx-query-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/this/repository/build/index.js"
      ]
    }
  }
}

2. Claude for Desktop を再起動します

3. Claude に次のことを依頼して、MCP サーバーを使用します：

   • Azure Data Explorer にログインする
   • KQL クエリを実行する

利用可能なツール

login-to-adx

クライアント資格情報を使用して Azure Data Explorer に認証します。

パラメーター：

• cluster：ADX クラスターの URL（例：https://mycluster.eastus.kusto.windows.net）
• database：データベース名
• tenantId：Azure テナント ID
• clientId：Azure クライアント／アプリケーション ID
• clientSecret：Azure クライアントシークレット

run-adx-query

接続済みの Azure Data Explorer データベースに対して KQL クエリを実行します。

パラメーター：

• query：実行する KQL クエリ

開発

開発モードでサーバーを実行するには：

npm run dev

ライセンス

ISC