Pab1it0 Adx MCP Server

🚀 Azure データエクスプローラー MCP サーバー

このサーバーは、Azure データエクスプローラー用の モデルコンテキストプロトコル (MCP) サーバーです。標準化された MCP インターフェースを通じて、このサーバーを使用して Azure データエクスプローラー クラスターとデータベースにアクセスでき、AI アシスタントが KQL クエリを実行してデータを探索することができます。

🚀 クイックスタート

このサーバーを使用することで、Azure データエクスプローラーのデータを AI アシスタントを通じて簡単に探索できます。以下の手順に従ってセットアップしてください。

✨ 主な機能

• [x] Azure データエクスプローラーに対する KQL クエリの実行
• [x] データベースリソースの発見と探索
  • [x] 構成されたデータベース内のテーブルの一覧表示
  • [x] テーブル構造の表示
  • [x] テーブルのサンプルデータの取得
• [x] 認証のサポート
  • [x] トークン認証情報（Azure CLI、MSI など）のサポート
• [x] Docker コンテナ化のサポート
• [x] AI アシスタント用の対話型ツールの提供

ツールリストは設定可能であり、MCP クライアントに提供するツールを選択できます。特定の機能を使用しない場合や、コンテキストウィンドウを占有したくない場合に便利です。

📦 インストール

環境設定

1. Azure CLI を使用して、Azure データエクスプローラー クラスターへのアクセス権を持つ Azure アカウントにログインします。
2. .env ファイルまたはシステム環境変数を使用して環境変数を設定します。

# 必須：Azure データエクスプローラーの設定
ADX_CLUSTER_URL=https://yourcluster.region.kusto.windows.net
ADX_DATABASE=your_database

3. サーバー設定をクライアント設定ファイルに追加します。例えば、Claude Desktop の場合：

{
  "mcpServers": {
    "adx": {
      "command": "uv",
      "args": [
        "--directory",
        "<adx-mcp-server フォルダへの完全パス>",
      ],
    },
  },
}

Docker を使用したセットアップ

• 以下のコマンドを使用してイメージをビルドします。

docker build -t azure-data-explorer-mcp .

• 以下のコマンドを使用してコンテナを実行します。

docker run --rm -it -e ADX_CLUSTER_URL=your_cluster_url -e ADX_DATABASE=your_database azure-data-explorer-mcp

💻 使用例

基本的な使用法

このサーバーを使用して Azure データエクスプローラーに対する KQL クエリを実行することができます。具体的な使用方法については、上記の「使用方法」セクションを参照してください。

📚 ドキュメント

ツール一覧

📄 ライセンス

MIT