MCP Kql Server

🚀 MCP KQL Server

MCP KQL Server 是一个微软云平台（MCP）服务器，可通过 Azure CLI 认证针对 Azure Data Explorer 执行 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 已开放且可访问。