使用说明

项目简介

Edge Delta MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为开发者和工具提供与 Edge Delta API 的无缝集成。它允许用户通过标准化的 MCP 协议，利用 LLM 应用访问和分析 Edge Delta 平台上的可观测性数据，从而构建 AI 驱动的智能化运维工具和应用。

主要功能点

• 可观测性数据访问: 提供对 Edge Delta 平台日志、事件和异常数据的查询和分析能力。
• 工具集成: 内置多种工具，包括日志搜索 (log_search)、事件搜索 (events_search)、异常事件搜索 (anomaly_search) 和模式统计 (pattern_stats)，方便 LLM 应用调用。
• 标准化 MCP 协议: 采用 JSON-RPC over Stdio 通信，易于集成到支持 MCP 协议的 LLM 客户端。
• Docker 部署: 提供 Docker 镜像，方便快速部署和运行。

安装步骤

1. 安装 Docker: 确保已安装 Docker Engine (版本 >= 20.10) 和 Docker Buildx 插件。
2. 获取 Edge Delta API 凭证:
   • 创建 Edge Delta API Token 并获取 Organization ID。 (创建 API Token 指引, 查找 Organization ID 指引)
3. 构建 Docker 镜像:
   • 执行以下命令构建 Docker 镜像，并将镜像加载到本地 Docker 守护进程：

     docker buildx create --name edgedelta-builder --use
     docker buildx inspect --bootstrap
     docker buildx build --load -t mcp/edgedelta .
     

服务器配置

在支持 MCP 协议的 LLM 客户端（如 Cursor）中，配置 MCP 服务器连接信息。以下为 Cursor 客户端的配置示例，其他客户端配置方式类似：

{
  "mcpServers": {
    "edgedelta": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "ED_ORG_ID=<YOUR_ORG_ID>",  // 请替换为您的 Edge Delta Organization ID
        "-e", "ED_API_TOKEN=<YOUR_TOKEN>", // 请替换为您的 Edge Delta API Token
        "ghcr.io/edgedelta/edgedelta-mcp-server:latest"
      ]
    }
  }
}

基本使用方法

1. 启动 MCP 服务器：按照上述配置，LLM 客户端会自动通过 Docker 运行 Edge Delta MCP Server。
2. 在 LLM 应用中，即可调用 'log_search', 'events_search', 'anomaly_search', 'pattern_stats' 等工具，查询和分析 Edge Delta 平台上的数据。
3. 工具的具体参数和使用方法，可以通过 LLM 客户端的工具schema查看，或参考项目代码 'pkg/core' 目录下的工具定义。