Azure Kusto MCP Server

基本能力

产品定位

Azure Kusto MCP Server 是一个连接 Azure Kusto 数据库的工具，旨在为 AI 助手提供数据探索和查询执行的能力，适用于数据分析和开发场景。

核心功能

• Azure Kusto 集成：安全连接到 Azure Kusto 集群
• 模式探索：将表模式作为资源暴露给 AI 助手
• 查询执行：运行 KQL 查询并分析结果
• 数据分析辅助：内置常见数据分析任务的提示
• VS Code 集成：在 VS Code 中交互式配置连接详情

适用场景

• 数据分析和查询执行
• 数据库模式探索
• 开发环境中的数据库集成
• AI 助手的数据访问

工具列表

• connect：连接到 Kusto 集群和数据库
• connection_status：检查当前连接状态
• execute_query：运行 KQL 查询
• analyze_data：执行查询并分析结果
• optimize_query：获取查询优化建议

常见问题解答

• 连接问题：确保 Azure 凭据有效且具有访问权限
• 查询执行问题：检查查询语法和数据量
• 数据分析问题：确保查询返回数据后再进行分析

使用教程

使用依赖

• Python 3.9+
• Azure Kusto 集群访问权限
• VS Code 及 GitHub Copilot 或 Copilot Chat 扩展

安装教程

快速安装（推荐）

python setup-mcp.py

手动安装

1. 克隆仓库：

git clone https://github.com/yourusername/kusto-mcp-server.git
cd kusto-mcp-server

1. 安装依赖：

pip install -r requirements.txt

1. 配置环境变量（可选）： 在根目录创建 .env 文件，内容如下：

AZURE_KUSTO_CLUSTER=https://<your-cluster>.kusto.windows.net
AZURE_KUSTO_DATABASE=<your-database>

调试方式

启动 MCP 服务器：

python -m src.kusto_mcp.server

高级用法

• 探索表模式
• 时间序列分析
• 相关性分析
• 数据质量检查
• 分步构建查询

最佳实践

1. 始终先使用 connect 工具
2. 验证连接状态
3. 从小查询开始
4. 使用分析工具
5. 请求查询优化

许可证

该项目遵循 MIT 开源许可条款。