PA

pab1it0/adx-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

59 stars 24 forks 品質 73 トレンド 13MIT

pab1it0/adx-mcp-serverは[https://github.com/pab1it0/adx-mcp-server.からインポートされたMCPサーバー候補です

概要

pab1it0/adx-mcp-serverは[https://github.com/pab1it0/adx-mcp-server.からインポートされたMCPサーバー候補です

概要(AI 翻訳)

AIアシスタントがKQLのクエリを実行し、標準化されたインターフェイスを介してAzure Data Explorer(ADX/Kusto)データベースを探索することを可能にするモデルコンテキストプロトコル(MCP)サーバー。

このサーバーは、Azure Data ExplorerとEventhouse(Microsoft Fabric)クラスターにシームレスなアクセスを提供し、AIアシスタントが強力なKusto Queryランゲージを使用してデータを照会および分析できるようにします。

##特徴

クエリ実行

  • Execute KQL クエリ - ADX データベースに対する任意の KQL クエリを実行
  • 徹底した結果 - 簡単に消費するためにJSONとしてフォーマットされた結果を得る

データベースのディスカバリー

  • リストテーブル - データベースのすべてのテーブルを発見
  • 図を参照 - 表のスキーマと列の型を調べる
  • サンプルデータ - 設定可能なサンプルサイズのプレビューテーブルコンテンツ
  • テーブル統計 - 行数とストレージサイズを含む詳細なメタデータを取得する

##認証 -DefaultAzureCredential - Azure CLI、マネージドIDなどのサポート

  • ワークロード・アイデンティティ - AKSのワークロード・アイデンティティのためのネイティブ サポート
  • 柔軟な認証 - 複数のAzure認証方法と連携

展開オプション

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Azure Data Explorer MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to execute KQL queries and explore Azure Data Explorer (ADX/Kusto) databases through standardized interfaces.

This server provides seamless access to Azure Data Explorer and Eventhouse (in Microsoft Fabric) clusters, allowing AI assistants to query and analyze your data using the powerful Kusto Query Language.

Features

Query Execution

  • Execute KQL queries - Run arbitrary KQL queries against your ADX database
  • Structured results - Get results formatted as JSON for easy consumption

Database Discovery

  • List tables - Discover all tables in your database
  • View schemas - Inspect table schemas and column types
  • Sample data - Preview table contents with configurable sample sizes
  • Table statistics - Get detailed metadata including row counts and storage size

Authentication

  • DefaultAzureCredential - Supports Azure CLI, Managed Identity, and more
  • Workload Identity - Native support for AKS workload identity
  • Flexible credentials - Works with multiple Azure authentication methods

Deployment Options

  • Multiple transports - stdio (default), HTTP, and Server-Sent Events (SSE)
  • Docker support - Production-ready container images with security best practices
  • Dev Container - Seamless development experience with GitHub Codespaces

The list of tools is configurable, so you can choose which tools you want to make available to the MCP client. This is useful if you don’t use certain functionality or if you don’t want to take up too much of the context window.

Usage

  1. Login to your Azure account which has the permission to the ADX cluster using Azure CLI.

  2. Configure the environment variables for your ADX cluster, either through a .env file or system environment variables:

# Required: Azure Data Explorer configuration
ADX_CLUSTER_URL=https://yourcluster.region.kusto.windows.net
ADX_DATABASE=your_database

# Optional: Azure Workload Identity credentials 
# AZURE_TENANT_ID=your-tenant-id
# AZURE_CLIENT_ID=your-client-id 
# ADX_TOKEN_FILE_PATH=/var/run/secrets/azure/tokens/azure-identity-token

# Optional: Custom MCP Server configuration
GitHub で README 全文を見る

インストール

docker run --rm -i -e ADX_CLUSTER_URL -e ADX_DATABASE -e AZURE_TENANT_ID -e AZURE_CLIENT_ID -e ADX_TOKEN_FILE_PATH adx-mcp-server
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "adx": { "command": "uv", "args": [ "--directory", "<full path to adx-mcp-server directory>", "run", "src/adx_mcp_server/main.py" ], "env": { "ADX_CLUSTER_URL": "https://yourcluster.region.kusto.windows.net", "ADX_DATABASE": "your_database" } } } }