edgedelta-mcp-server

用途

Edge Delta MCP Server 是一个基于模型上下文协议（MCP）的服务器，旨在提供与 Edge Delta API 的无缝集成，使开发者和工具能够实现高级自动化和交互能力。它主要用于从 Edge Delta 提取和分析可观测性数据，并支持构建与 Edge Delta 平台交互的 AI 驱动工具和应用。

主要能力

1. 管道配置工具：服务器暴露了检查和更改 Edge Delta 管道的工具。写操作遵循安全循环：校验 → 保存 → 部署，并支持回滚。典型的编辑流程为：get_pipeline_config → 编辑 YAML → validate_pipeline_config → save_pipeline_config → get_pipeline_history → deploy_pipeline（使用 revert_pipeline 回滚）。
2. 实时捕获工具：验证配置有效并不等同于确认更改实际转换了数据。实时捕获工具对运行中代理上管道节点的真实前后数据进行采样，以便代理可以验证转换是否生效。捕获流程：start_pipeline_capture → get_pipeline_capture_status（轮询直到代理报告成功）→ get_pipeline_capture_results（比较每个节点的前后数据以确认转换）。
3. 处理器干跑（测试）工具：离线针对样本日志开发和验证处理器——无需保存、无需部署、无需实时流量。这是实时捕获的离线补充：捕获证明实际发生了什么，干跑证明将要发生什么。迭代直到输出正确，然后将语句/节点添加到管道，执行 save_pipeline_config → deploy_pipeline，并使用捕获工具在实时数据上确认。对于 OTTL 转换使用 test_pipeline_ottl（其 ExtractPatterns 也涵盖正则字段提取）；对于非 OTTL 节点类型（如 log-to-metric 和 log-to-pattern），使用 test_pipeline_node。

使用方式

前置要求

• Docker Engine ≥ 20.10 已安装并运行。
• Docker Buildx 插件可用：
  • macOS / Windows – 包含在 Docker Desktop 中。
  • Debian / Ubuntu：sudo apt-get update && sudo apt-get install -y docker-buildx-plugin
  • Fedora / RHEL / CentOS：sudo dnf install -y docker-buildx-plugin 或 yum install …
  • 其他发行版（手动回退）：

    mkdir -p ~/.docker/cli-plugins
    curl -sSL \
      https://github.com/docker/buildx/releases/latest/download/buildx-$(uname -s | tr '[:upper:]' '[:lower:]')-amd64 \
      -o ~/.docker/cli-plugins/docker-buildx
    chmod +x ~/.docker/cli-plugins/docker-buildx
    

• 具有所需范围的 Edge Delta API 令牌（在此创建）。
• 您的 Edge Delta 组织 ID（在此查找）。

构建（容器镜像） 首次设置（创建多平台构建器并启动）： 构建镜像并加载到本地 Docker 守护进程： ℹ️ --load 标志将镜像流回本地 Docker 引擎，以便您可以直接使用 docker run mcp/edgedelta … 运行。

与 Cursor 一起使用

适用场景

• 从 Edge Delta 提取和分析可观测性数据。
• 构建与 Edge Delta 平台交互的 AI 驱动工具和应用。
• 检查、编辑、验证、保存、部署和回滚 Edge Delta 管道。
• 通过实时捕获验证管道转换效果。
• 离线开发和测试处理器逻辑，避免影响实时流量。

限制

• 本模块导出的 Go API 是实验性的，可能在不通知的情况下更改。如果在生产中使用，请打开 issue 描述您的用例，以便稳定相关接口。
• 需要满足前置要求（Docker、Buildx、API 令牌、组织 ID）。
• 许可：MIT 许可证。详见 LICENSE。
• 安全策略：参见仓库中的安全策略。