pab1it0/adx-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

59 stars 24 forks 품질 73 트렌드 13MIT

Repository Install

pab1it0/adx-mcp-server는 MCP 서버 후보가 https://github.com/pab1it0/adx-mcp-server.에서 수입되었습니다

개요

pab1it0/adx-mcp-server는 MCP 서버 후보가 https://github.com/pab1it0/adx-mcp-server.에서 수입되었습니다

개요(AI 번역)

A Model Context Protocol (MCP) 서버는 KQL 쿼리를 실행하고 표준화 된 인터페이스를 통해 Azure Data Explorer (ADX/Kusto) 데이터베이스를 탐구하는 AI 조수를 가능하게합니다.

이 서버는 Azure Data Explorer 및 Eventhouse (Microsoft Fabric에서) 클러스터에 원활한 액세스를 제공합니다. AI 조수를 쿼리하고 강력한 Kusto Query 언어를 사용하여 데이터를 분석 할 수 있습니다.

특징

Query 실행

-Execute KQL 쿼리 - ADX 데이터베이스에 대한 임의 KQL 쿼리 실행 -Structured result - 간편한 소비를 위해 JSON으로 포맷된 결과를 가져옵니다.

데이터베이스 검색

-List table - 데이터베이스에서 모든 테이블을 발견

** 스키마보기 ** - 테이블 스키마 및 열 유형 검사
Sample data - 구성 가능한 샘플 크기로 미리보기 테이블 내용
**Table 통계 ** - 행 수와 저장 크기를 포함하여 상세한 메타 데이터를 얻으십시오

인증

DefaultAzureCredential - Azure CLI, Managed Identity 및 더 많은 지원
Workload Identity - AKS 워크로드 정체성에 대한 기본 지원 -Flexible credentials - 여러 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

Login to your Azure account which has the permission to the ADX cluster using Azure CLI.
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"
      }
    }
  }
}