edgedelta-mcp-server

Edge Delta MCP Server

The Edge Delta MCP Server is a Model Context Protocol (MCP) server that provides seamless integration with Edge Delta APIs, enabling advanced automation and interaction capabilities for developers and tools.

Use Cases

• Extract and analyse observability data from Edge Delta.
• Build AI‑powered tools and applications that interact with Edge Delta’s platform.

Pipeline Configuration Tools

The server exposes tools to inspect and change Edge Delta pipelines. Write operations follow a safe loop: validate → save → deploy, with rollback.

| Tool | What it does | |------|--------------| | get_pipelines / get_pipeline_config / get_pipeline_history | Discover pipelines and read their config and version history. | | validate_pipeline_config | Validate a config YAML without saving it. Returns {valid, reason}. | | save_pipeline_config | Save the full config YAML as a new version (does not deploy). | | deploy_pipeline | Deploy a saved version to the fleet. | | revert_pipeline | Roll back to a previously saved version. | | add_pipeline_source | Add a data source node to a pipeline. |

Typical edit flow: get_pipeline_config → edit YAML → validate_pipeline_config → save_pipeline_config → get_pipeline_history → deploy_pipeline (revert_pipeline to roll back).

Live-capture tools

Validating that a config is valid is not the same as confirming a change actually transformed the data. The live-capture tools sample real before/after data flowing through pipeline nodes on running agents, so an agent can verify a transformation took effect.

| Tool | What it does | |------|--------------| | start_pipeline_capture | Start a capture task on a pipeline (duration, optional node list, max items). | | get_pipeline_capture_status | Poll per-agent status for a capture task. | | get_pipeline_capture_results | Fetch captured before/after samples per node. | | get_pipeline_capture_task | Show the currently active capture task, if any. |

Capture flow: start_pipeline_capture → get_pipeline_capture_status (poll until an agent reports success) → get_pipeline_capture_results (compare each node's before vs after to confirm the transformation).

Processor dry-run (test) tools

Develop and verify a processor against sample logs offline — no save, no deploy, no live traffic. The offline complement to live-capture: capture proves what did happen, this proves what will happen.

| Tool | What it does | |------|--------------| | test_pipeline_ottl | Dry-run OTTL statements against sample OTEL log items; returns the transformed items. | | test_pipeline_node | Dry-run a full processor node of any type (log_to_metric, log_to_pattern, extract_metric, parse_json_attributes, grok, mask, …); returns the items it emits per output path. |

Iterate until the output is right, then add the statements/node to the pipeline, save_pipeline_config → deploy_pipeline, and confirm on live data with the capture tools. Use test_pipeline_ottl for OTTL transforms (its ExtractPatterns also covers regex field extraction); use test_pipeline_node for non-OTTL node types such as log-to-metric and log-to-pattern.

Prerequisites

1. Docker Engine ≥ 20.10 installed and running.
2. Docker Buildx plug‑in available:

• macOS / Windows – included with 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   # or yum install …

• Other distros (manual fallback)

     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

1. An Edge Delta API token with the required scope – create one here.
2. Your Edge Delta organisation ID – find it here.

Build (container image)

First‑time setup (creates a multi‑platform builder and boots it):

docker buildx create --name edgedelta-builder --use
docker buildx inspect --bootstrap

Build the image and load it into the local Docker daemon:

docker buildx build --load -t mcp/edgedelta .

ℹ️ The --load flag streams the image back to your local Docker engine so you can run it directly with docker run mcp/edgedelta ….

Installation

Usage with Cursor

{
  "mcpServers": {
    "edgedelta": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e ED_ORG_ID",
        "-e ED_API_TOKEN",
        "ghcr.io/edgedelta/edgedelta-mcp-server:latest"
      ],
      "env": {
        "ED_API_TOKEN": "<YOUR_TOKEN>",
        "ED_ORG_ID": "<YOUR_ORG_ID>"
      }
    }
  }
}

Library Usage

The exported Go API of this module is experimental and may change without notice. If you rely on it in production, please open an issue describing your use case so we can stabilise the relevant surface.

License

Licensed under the terms of the MIT licence. See LICENSE for full details.