Adx MCP Server

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

Model Context Protocol（MCP）プロトコルをサポートする Azure データエクスプローラ（Azure Data Explorer）サーバです。

このサーバは、あなたの Azure データエクスプローラクラスターとデータベースへの標準的な MCP インターフェイスアクセスを提供し、AI アシスタントが KQL クエリを実行してデータを探索できるようにします。

✨ 主な機能

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

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

🚀 クイックスタート

🔧 設定手順

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

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

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

{
  "mcpServers": {
    "adx": {
      "command": "uv",
      "args": [
        "--directory",
        "<あなたの adx - mcp - server ディレクトリの完全パス>",
        "run"
      ],
      "environment": {
        "ADX_CLUSTER_URL": "https://yourcluster.region.kusto.windows.net",
        "ADX_DATABASE": "your_database"
      }
    }
  }
}

🐳 Docker を使用したサーバの実行

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

# Docker イメージのビルド
docker build -t adx-mcp-server .

# コンテナの実行
docker run --name adx-mcp-server -p 8000:8000 adx-mcp-server

Claude デスクトップ版でサーバ URL を設定するには、次のようにします。

{
  "mcpServers": {
    "adx": {
      "url": "http://localhost:8000"
    }
  }
}

📚 ドキュメント

🛠️ 開発ツール

📁 プロジェクト構造

.
├── src/
│   ├── server.py          # MCP サーバの実装
│   └── main.py           # メインアプリケーションロジック
├── Dockerfile            # Docker の設定ファイル
├── docker-compose.yml    # Docker Compose の設定
├── .dockerignore         # Docker が無視するファイル
├── pyproject.toml        # プロジェクトの設定ファイル
└── README.md             # このファイル

🧪 テスト

このプロジェクトには、機能を確保して回帰を防止するための包括的なテストスイートが含まれています。

# 開発用依存関係のインストール
uv pip install -e ".[dev]"

# テストの実行
pytest

# カバレッジレポートの生成
pytest --cov=src --cov-report=term-missing

📄 ライセンス

MIT