Azure Log Analytics MCP Server

Azure Log Analytics MCP 服务

一个使用自然语言查询 Azure Log Analytics 的 MCP（Model Context Protocol）服务。该服务可让大模型将自然语言查询转换为 KQL（Kusto Query Language），并在 Azure Log Analytics 中执行。

功能

• 使用 Claude AI 将自然语言查询转换为 KQL
• 在 Azure Log Analytics 中执行 KQL 查询
• 格式化结果，方便大模型使用
• 提供用于直接交互的 CLI 模式和用于大模型集成的 MCP 服务模式

前提条件

• Node.js 18.x 或更高版本
• 包含 Log Analytics 工作区的 Azure 订阅
• 用于 Claude AI 的 Anthropic API 密钥
• 已配置相应凭据的 Azure CLI

安装

# Clone the repository
git clone https://github.com/MananShahTR/azure-log-analytics-mcp.git
cd azure-log-analytics-mcp

# Install dependencies
npm install

# Build the project
npm run build

配置

该服务需要以下环境变量：

• ANTHROPIC_API_KEY：用于 Claude AI 的 Anthropic API 密钥

Azure 凭据通过 Azure CLI 获取。运行服务前，请确保已使用 az login 登录。

你需要在 azure-service.ts 文件中配置以下内容：

• subscriptionId：Azure 订阅 ID
• resourceGroup：包含 App Insights 资源的资源组
• appInsightsId：Application Insights 资源的名称

使用方法

CLI 工具

# Run as a CLI tool
ANTHROPIC_API_KEY=your_key_here node build/index.js

MCP 服务

# Run as an MCP server
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 Log Analytics
  • 参数：
    • query：关于跟踪日志的自然语言查询（必填）
    • timeRange：可选的时间范围（例如，“过去 24 小时”“过去一周”）
    • limit：要返回的最大结果数

示例

// Example MCP tool use
use_mcp_tool({
  server_name: "azure-log-analytics",
  tool_name: "query_logs",
  arguments: {
    query: "Show me all errors in the authentication service from the last hour",
    timeRange: "last hour",
    limit: 10
  }
});

许可证

MIT