mcp-kql-server

🚀 MCP KQL 服务器

MCP KQL 服务器是基于微软云平台（MCP）构建的，它借助 Azure CLI 身份验证机制，能够高效执行针对 Azure 数据探索者的 KQL 查询，为数据查询工作提供了便捷的解决方案。

🚀 快速开始

安装

1. 确保已安装 uv：

   pip install uv
   

2. 创建虚拟环境并安装依赖项：

   uvx venv
   source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate
   uvx pip install .
   

运行服务器

使用以下命令启动服务器：

uvx run start

服务器将在 http://0.0.0.0:5000 可用。

💻 使用示例

基础用法

身份验证

curl -X POST http://localhost:5000/auth

执行 KQL 查询

curl -X POST http://localhost:5000/execute \
       -H "Content-Type: application/json" \
       -d '{"query": "cluster('\''mycluster'\'').database('\''mydb'\'').MyTable | take 10"}'

高级用法

集成到 Claude Desktop

在 claude_desktop_config.json 中配置服务器，以启用 Claude Desktop 中的 kql_execute 工具。参见 mcp_config.yaml 了解工具详细信息。

🔧 技术细节

要求

• Python 3.9
• Azure CLI (az) 进行身份验证
• 依赖项：Flask、waitress、azure-kusto-data、tenacity

故障排除

• 确保 Azure CLI 已身份验证：az login
• 检查服务器日志中的错误。
• 验证端口 5000 是否开放且可访问。