Kusto MCP Server

基本能力

产品定位

ZZZHDW_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)

适用场景

• 需要管理和查询 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 模拟器时，不需要提供 --authority_id, --client_id, --client_secret 参数
• 本地模拟器的集群 URL 应提供为 https://localhost:8082

使用教程

使用依赖

需要安装 Azure Data Explorer 和相关的客户端工具。

安装教程

编辑 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}}"
      ]
    }
  }
}

对于本地模拟器，配置如下：

{
  "mcpServers": {
    "kusto": {
      "command": "uv",
      "args": [
        "--directory",
        "{{PATH_TO_PROJECT}}\\mcp-server-kusto\\src\\mcp_server_kusto",
        "run",
        "mcp-server-kusto",
        "--cluster",
        "{{ADX_CLUSTER_URL}}"
      ]
    }
  }
}

调试方式

运行配置好的命令后，可以使用提供的工具进行查询和表结构获取操作。

许可证

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