Azure Data Explorer MCP Server
2025.04.13
0
Python数据库服务数据查询数据库
Azure Data Explorer MCP Server 是一个基于模型上下文协议（MCP）的服务器，专门为Azure Data Explorer设计。它提供了标准化的MCP接口，允许AI助手执行KQL查询并探索数据。该服务器支持多种功能，包括执行KQL查询、发现和探索数据库资源、认证支持以及Docker容器化支持。
View on GitHub
Overview
基本能力
产品定位
Azure Data Explorer MCP Server 是一个专门为Azure Data Explorer设计的MCP服务器，旨在通过标准化的MCP接口提供数据查询和探索功能。
核心功能
- 执行KQL查询
- 发现和探索数据库资源
- 列出配置数据库中的表
- 查看表结构
- 从表中采样数据
- 认证支持
- 令牌凭证支持（Azure CLI、MSI等）
- Docker容器化支持
- 提供交互式工具给AI助手
适用场景
- AI助手需要执行KQL查询的场景
- 需要探索和发现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