Azure Data Explorer MCP Server
2025.04.16
26
Python数据查询数据库管理数据库
Azure Data Explorer MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，专门用于与 Azure Data Explorer (ADX) 集群和数据库进行交互。它通过标准化的 MCP 接口，使 AI 助手能够执行 KQL 查询并探索数据。该服务器支持多种认证方式，包括 Azure CLI 和 MSI，并提供了 Docker 容器化支持，便于部署和隔离。
View on GitHub
Overview
基本能力
产品定位
Azure Data Explorer MCP Server 是一个专为 Azure Data Explorer 设计的 MCP 服务器，旨在通过标准化的接口提供数据查询和探索功能。
核心功能
- 执行 KQL 查询
- 发现和探索数据库资源
- 列出配置数据库中的表
- 查看表结构
- 从表中采样数据
- 认证支持
- 令牌凭证支持（Azure CLI、MSI 等）
- Docker 容器化支持
- 提供交互式工具供 AI 助手使用
适用场景
- AI 助手需要查询和分析 Azure Data Explorer 中的数据
- 开发人员需要快速探索数据库结构和内容
- 需要容器化部署的数据查询服务
工具列表
| 工具 | 类别 | 描述 |
|---|---|---|
execute_query |
查询 | 在 Azure Data Explorer 上执行 KQL 查询 |
list_tables |
发现 | 列出配置数据库中的所有表 |
get_table_schema |
发现 | 获取特定表的结构 |
sample_table_data |
发现 | 从表中获取样本数据，可选择样本大小 |
常见问题解答
- 如果在 Claude Desktop 中看到
Error: spawn uv ENOENT，可能需要指定uv的完整路径或在配置中设置环境变量NO_UV=1。
使用教程
使用依赖
- 安装
uv工具：
curl -LsSf https://astral.sh/uv/install.sh | sh
安装教程
- 登录具有 ADX 集群权限的 Azure 账户：
az login
- 配置环境变量（通过
.env文件或系统环境变量）：
ADX_CLUSTER_URL=https://yourcluster.region.kusto.windows.net
ADX_DATABASE=your_database
- 创建虚拟环境并安装依赖：
uv venv
source .venv/bin/activate # On Unix/macOS
.venv\Scripts\activate # On Windows
uv pip install -e .
调试方式
- 运行测试：
uv pip install -e ".[dev]"
pytest
- 运行覆盖率报告：
pytest --cov=src --cov-report=term-missing
Docker 使用
构建 Docker 镜像
docker build -t adx-mcp-server .
运行 Docker 容器
docker run -it --rm \
-e ADX_CLUSTER_URL=https://yourcluster.region.kusto.windows.net \
-e ADX_DATABASE=your_database \
adx-mcp-server
使用 docker-compose
docker-compose up