pab1it0/adx-mcp-server

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

59 stars 24 forks Качество 73 Тренд 13MIT

Repository Install

pab1it0/adx-mcp-сервер является кандидатом MCP-сервера, импортированным из https://github.com/pab1it0/adx-mcp-server.

Обзор

pab1it0/adx-mcp-сервер является кандидатом MCP-сервера, импортированным из https://github.com/pab1it0/adx-mcp-server.

Обзор (машинный перевод)

Сервер [Model Context Protocol] mcp (MCP), который позволяет помощникам ИИ выполнять запросы KQL и исследовать базы данных Azure Data Explorer (ADX/Kusto) через стандартизированные интерфейсы.

Этот сервер обеспечивает беспрепятственный доступ к кластерам Azure Data Explorer и Eventhouse (в Microsoft Fabric), позволяя помощникам ИИ запрашивать и анализировать ваши данные с помощью мощного языка запросов Kusto.

Особенности

Запрос исполнения

** Исполните запросы KQL** Запустите произвольные запросы KQL в базе данных ADX Структурные результаты Получить результаты, отформатированные как JSON для простого потребления

###Обнаружение базы данных ** Таблицы списков ** - Откройте все таблицы в своей базе данных Просмотр схем - Проверка схем таблиц и типов колонок ** Примерные данные** - Содержимое таблицы предварительного просмотра с настраиваемыми размерами выборки ** Статистика таблиц ** - Получите подробные метаданные, включая количество строк и размер хранилища

Аутентификация

DefaultAzureCredential - поддерживает Azure CLI, Managed Identity и многое другое ** Идентификатор рабочей нагрузки** - Родная поддержка идентификации рабочей нагрузки АКС ** Гибкие учетные данные** Работает с несколькими методами аутентификации Azure

Варианты развертывания

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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

Открыть полный README на GitHub

Установка

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"
      }
    }
  }
}