基本能力
产品定位
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
手动安装
- 克隆仓库:
git clone https://github.com/yourusername/kusto-mcp-server.git
cd kusto-mcp-server - 安装依赖:
pip install -r requirements.txt
- 配置环境变量(可选):
在根目录创建.env
文件,内容如下:
AZURE_KUSTO_CLUSTER=https://<your-cluster>.kusto.windows.net
AZURE_KUSTO_DATABASE=<your-database>
调试方式
启动 MCP 服务器:
python -m src.kusto_mcp.server
高级用法
- 探索表模式
- 时间序列分析
- 相关性分析
- 数据质量检查
- 分步构建查询
最佳实践
- 始终先使用
connect
工具 - 验证连接状态
- 从小查询开始
- 使用分析工具
- 请求查询优化