Azure Log Analytics MCP

🚀 Azure 對象分析器日誌 MCP 服務器

Azure 對象分析器日誌 MCP 服務器是一個強大的工具，它允許通過自然語言查詢 Azure 對象分析器的日誌。該服務器能讓大型語言模型將自然語言查詢轉化為 KQL（Kusto 查詢語言），並在 Azure 對象分析器中執行這些查詢，極大地提升了日誌查詢的便捷性。

✨ 主要特性

• 智能查詢轉換：藉助 Claude AI，將自然語言查詢精準轉換為 KQL。
• 高效查詢執行：執行 KQL 查詢，快速訪問 Azure 對象分析器。
• 結果友好呈現：格式化查詢結果，方便大型語言模型（LLMs）輕鬆消費。
• 靈活使用模式：支持 CLI 模式進行直接交互，也支持 MCP 服務器模式與 LLM 集成。

📦 安裝指南

# 克隆倉庫
git clone https://github.com/MananShahTR/azure-log-analytics-mcp.git
cd azure-log-analytics-mcp

# 安裝依賴項
npm install

# 構建項目
npm run build

📚 詳細文檔

先決條件

• 安裝 Node.js 18.x 或更高版本。
• 擁有帶有對對象分析器工作區的 Azure 訂閱。
• 獲取 Anthropic API 密鑰，以便使用 Claude AI。
• 安裝並配置好帶有適當憑據的 Azure CLI。

配置

服務器運行需要設置以下環境變量：

• ANTHROPIC_API_KEY：用於使用 Claude AI 的 Anthropic API 密鑰。

Azure 憑證通過 Azure CLI 憑據獲取。在運行服務器之前，請確保已使用 az login 登錄。

您還需要在 azure-service.ts 文件中配置以下內容：

• subscriptionId：您的 Azure 訂閱 ID。
• resourceGroup：包含您的對象分析器資源的資源組。
• appInsightsId：您的應用程序見解資源的名稱。

使用方法

CLI 工具

# 作為 CLI 工具運行
ANTHROPIC_API_KEY=your_key_here node build/index.js

MCP 服務器

# 作為 MCP 服務器運行
ANTHROPIC_API_KEY=your_key_here node build/mcp-server.js

MCP 設置配置

將以下內容添加到您的 MCP 設置配置文件中：

{
  "mcpServers": {
    "azure-log-analytics": {
      "command": "node",
      "args": ["path/to/azure-log-analytics-mcp/build/mcp-server.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your_key_here"
      }
    }
  }
}

工具使用

一旦連接，MCP 服務器提供以下工具：

• query_logs：使用自然語言查詢 Azure 對象分析器。
  • 參數：
    • query：關於跟蹤日誌的自然語言查詢（必需）。
    • timeRange：可選時間範圍（例如，“過去 24 小時”，“上週”）。
    • limit：要返回的最大結果數。

💻 使用示例

基礎用法

// MCP 工具使用的示例
use_mcp_tool({
  server_name: "azure-log-analytics",
  tool_name: "query_logs",
  // 此處可補充具體參數內容
});