Kusto MCP Server

基本能力

产品定位

mcp-server-kusto 是一个专门用于与 Azure Data Explorer (ADX) 集群交互的 MCP 服务器，提供数据查询和管理功能。

核心功能

• 列出表
• list_internal_tables: 列出集群中的所有内部表
• list_external_tables: 列出集群中的所有外部表

• list_materialized_views: 列出集群中的所有物化视图

• 执行查询

• execute_query_internal_table: 在内部表或物化视图上执行查询

• execute_query_external_table: 在外部表上执行查询

• 获取表结构

• get_internal_table_schema: 获取内部表或物化视图的结构
• get_external_table_schema: 获取外部表的结构

适用场景

• 数据分析：通过查询 ADX 集群中的数据进行分析
• 数据管理：管理和查看 ADX 集群中的表结构
• 本地开发：使用 Azure Data Explorer 模拟器进行本地开发和测试

工具列表

• list_internal_tables: 列出所有内部表
• list_external_tables: 列出所有外部表
• list_materialized_views: 列出所有物化视图
• execute_query_internal_table: 在内部表或物化视图上执行查询
• execute_query_external_table: 在外部表上执行查询
• get_internal_table_schema: 获取内部表或物化视图的结构
• get_external_table_schema: 获取外部表的结构

常见问题解答

• 如何配置本地 Azure Data Explorer 模拟器？ 提供集群 URL 如 https://localhost:8082，无需提供 --authority_id、--client_id 和 --client_secret。

使用教程

使用依赖

确保已安装以下依赖：

• Python 3.x
• uv 工具

安装教程

1. 克隆项目到本地
2. 编辑 claude_desktop_config.json 文件，添加以下配置：

{
  "mcpServers": {
    "kusto": {
      "command": "uv",
      "args": [
        "--directory",
        "{{PATH_TO_PROJECT}}\\mcp-server-kusto\\src\\mcp_server_kusto",
        "run",
        "mcp-server-kusto",
        "--cluster",
        "{{ADX_CLUSTER_URL}}",
        "--authority_id",
        "{{TENANT_ID}}",
        "--client_id",
        "{{CLIENT_ID}}",
        "--client_secret",
        "{{CLIENT_SECRET}}"
      ]
    }
  }
}

1. 运行服务器

调试方式

使用以下命令启动服务器并进行调试：

uv --directory {{PATH_TO_PROJECT}}\\mcp-server-kusto\\src\\mcp_server_kusto run mcp-server-kusto --cluster {{ADX_CLUSTER_URL}}

对于本地模拟器，无需提供认证信息：

uv --directory {{PATH_TO_PROJECT}}\\mcp-server-kusto\\src\\mcp_server_kusto run mcp-server-kusto --cluster https://localhost:8082

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。