Edge Delta MCP Server

Se integra con las APIs de Edge Delta para automatización e interacción avanzadas.

Documentación

Edge Delta MCP Server

El Edge Delta MCP Server es un servidor de Model Context Protocol (MCP) que proporciona una integración perfecta con las APIs de Edge Delta, habilitando capacidades avanzadas de automatización e interacción para desarrolladores y herramientas.

Casos de uso

Extraer y analizar datos de observabilidad de Edge Delta.
Construir herramientas y aplicaciones impulsadas por IA que interactúen con la plataforma de Edge Delta.

Herramientas de configuración de pipelines

El servidor expone herramientas para inspeccionar y modificar pipelines de Edge Delta. Las operaciones de escritura siguen un bucle seguro: validar → guardar → desplegar, con reversión.

Herramienta	Qué hace
`get_pipelines` / `get_pipeline_config` / `get_pipeline_history`	Descubrir pipelines y leer su configuración e historial de versiones.
`validate_pipeline_config`	Validar un YAML de configuración sin guardarlo. Devuelve `{valid, reason}`.
`save_pipeline_config`	Guardar el YAML de configuración completo como una nueva versión (no despliega).
`deploy_pipeline`	Desplegar una versión guardada en el fleet.
`revert_pipeline`	Revertir a una versión guardada anteriormente.
`add_pipeline_source`	Añadir un nodo de fuente de datos a un pipeline.

Flujo de edición típico: get_pipeline_config → editar YAML → validate_pipeline_config → save_pipeline_config → get_pipeline_history → deploy_pipeline (revert_pipeline para revertir).

Herramientas de captura en vivo

Validar que una configuración es válida no es lo mismo que confirmar que un cambio realmente transformó los datos. Las herramientas de captura en vivo muestrean datos reales de antes/después que fluyen a través de los nodos del pipeline en agentes en ejecución, para que un agente pueda verificar que una transformación tuvo efecto.

Herramienta	Qué hace
`start_pipeline_capture`	Iniciar una tarea de captura en un pipeline (duración, lista opcional de nodos, máximo de elementos).
`get_pipeline_capture_status`	Consultar el estado por agente de una tarea de captura.
`get_pipeline_capture_results`	Obtener muestras capturadas de antes/después por nodo.
`get_pipeline_capture_task`	Mostrar la tarea de captura actualmente activa, si existe.

Flujo de captura: start_pipeline_capture → get_pipeline_capture_status (consultar hasta que un agente informe success) → get_pipeline_capture_results (comparar el before de cada nodo con after para confirmar la transformación).

Herramientas de prueba (dry-run) de procesadores

Desarrollar y verificar un procesador con registros de muestra sin conexión — sin guardar, sin desplegar, sin tráfico en vivo. El complemento sin conexión de la captura en vivo: la captura demuestra lo que ocurrió, esto demuestra lo que ocurrirá.

Herramienta	Qué hace
`test_pipeline_ottl`	Ejecutar en seco (dry-run) sentencias OTTL contra elementos de registro OTEL de muestra; devuelve los elementos transformados.
`test_pipeline_node`	Ejecutar en seco (dry-run) un nodo de procesador completo de cualquier tipo (`log_to_metric`, `log_to_pattern`, `extract_metric`, `parse_json_attributes`, `grok`, `mask`, …); devuelve los elementos que emite por ruta de salida.

Iterar hasta que la salida sea correcta, luego añadir las sentencias/nodo al pipeline, save_pipeline_config → deploy_pipeline, y confirmar con datos en vivo usando las herramientas de captura. Usar test_pipeline_ottl para transformaciones OTTL (su ExtractPatterns también cubre la extracción de campos con regex); usar test_pipeline_node para tipos de nodo no OTTL como log-to-metric y log-to-pattern.

Requisitos previos

Docker Engine ≥ 20.10 instalado y en ejecución.

Complemento Docker Buildx disponible:

macOS / Windows – incluido con 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 …

Otras distribuciones (alternativa manual)

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

Un token de API de Edge Delta con el ámbito requerido – crea uno aquí.
Tu ID de organización de Edge Delta – encuéntralo aquí.

Compilación (imagen de contenedor)

Configuración inicial (crea un builder multi-plataforma y lo inicia):

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

Compilar la imagen y cargarla en el daemon local de Docker:

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

ℹ️ La bandera --load transmite la imagen de vuelta a tu motor Docker local para que puedas ejecutarla directamente con docker run mcp/edgedelta ….

Instalación

Uso con 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>"
      }
    }
  }
}

Uso de la biblioteca

La API Go exportada de este módulo es experimental y puede cambiar sin previo aviso. Si dependes de ella en producción, abre un issue describiendo tu caso de uso para que podamos estabilizar la superficie relevante.

Licencia

Licenciado bajo los términos de la licencia MIT. Consulta LICENSE para más detalles.