MCP Kusto

🚀 Azure Kusto MCP 服務器配置指南

Azure Kusto Model Context Protocol (MCP) 服務器是一款強大的工具，可用於與 Azure Kusto 查詢語言（KQL）進行交互。本指南將詳細闡述該服務器的配置與使用方法，涵蓋故障排除、最佳實踐以及示例查詢等內容。

🚀 快速開始

配置步驟

1. 創建 MCP 配置文件

在項目的根目錄下創建一個名為 mcp.json 的文件，並添加以下內容：

{
    "servers": [
        {
            "name": "KustoMCP",
            "hostname": "<kusto-cluster-endpoint>",
            "port": 443,
            "database": "<database-name>",
            "table": "<table-name>",
            "enableTelemetry": true
        }
    ],
    "tracing": {
        "enabled": false,
        "samplingRate": 100
    },
    "tools": {
        "queryCompletion": {
            "enabled": true,
            "maxTokens": 500
        }
    }
}

2. 配置 Visual Studio Code

在 VS Code 中，導航到 .vscode 文件夾並創建一個新的 mcp.json 文件。添加以下內容：

{
    "configurations": [
        {
            "name": "KustoMCP",
            "type": "ms-kusto",
            "request": "launch",
            "serverUrl": "<kusto-cluster-endpoint>",
            "databaseName": "<database-name>",
            "tableName": "<table-name>"
        }
    ]
}

✨ 主要特性

• 可與 Azure Kusto 查詢語言（KQL）進行交互。
• 支持在 VS Code 中進行調試和查詢操作。
• 提供了豐富的工具和命令，方便進行數據連接、查詢、分析等操作。

📦 安裝指南

本部分內容主要為配置步驟，具體配置方法見“快速開始”部分。

💻 使用示例

基礎用法

1. 連接集群

在 VS Code 中啟動調試會話：

# 在終端中運行以下命令
az login
kustoctl --endpoint <kusto-cluster-endpoint> query "help;"

2. 執行查詢

直接在 VS Code 的編輯器中編寫 KQL 查詢並執行。例如：

StormEvents
| where State == "FLORIDA"
| take 10

3. 分析數據

使用 analyze 命令對結果進行分析：

az kusto analyze --cluster <kusto-cluster-endpoint> --database <database-name> --query "<your-query-here>"

高級用法

1. 基本查詢

StormEvents
| where State == "FLORIDA"
| project TimeStamp, Severity, EventType

2. 時間序列分析

HeartRateData
| where HeartRate > 100
| order by Timestamp asc

3. 數據聚合

SalesData
| summarize TotalSales = sum(SalesAmount) by Region, Month

📚 詳細文檔

故障排除

1. 配置問題

• 錯誤：無法連接到集群
  檢查 mcp.json 文件中的 hostname 和 port 是否正確。
• 錯誤：未檢測到 MCP 服務器
  確保 mcp.json 文件位於項目的 .vscode 目錄中。

2. 查詢問題

• 錯誤：超時
  在查詢中添加過濾條件或時間限制。
• 錯誤：語法錯誤
  使用 optimize_query 工具檢查和修復查詢語法。

最佳實踐

1. 始終先連接：在執行查詢之前，使用 connect 工具建立連接。
2. 驗證連接狀態：使用 connection_status 工具確認連接是否正常。
3. 從小規模開始：在測試時，使用 take 或 limit 操作符限制數據量。
4. 利用分析工具：analyze_data 工具可以幫助您快速獲取有價值的信息。
5. 請求優化：對於複雜查詢，使用 optimize_query 工具進行優化。

總結

通過本指南，您可以輕鬆配置和使用 Azure Kusto MCP 服務器，並掌握基本的查詢和分析方法。若遇到問題，請參考提供的故障排除指南解決問題。