Edge Delta MCP Server

Integra-se com as APIs do Edge Delta para automação e interação avançadas.

Documentação

Edge Delta MCP Server

O Edge Delta MCP Server é um servidor Model Context Protocol (MCP) que fornece integração perfeita com as APIs do Edge Delta, permitindo automação avançada e capacidades de interação para desenvolvedores e ferramentas.

Casos de Uso

Extrair e analisar dados de observabilidade do Edge Delta.
Construir ferramentas e aplicações com tecnologia de IA que interagem com a plataforma do Edge Delta.

Ferramentas de Configuração de Pipelines

O servidor expõe ferramentas para inspecionar e alterar pipelines do Edge Delta. As operações de escrita seguem um loop seguro: validar → salvar → implantar, com rollback.

Ferramenta	O que faz
`get_pipelines` / `get_pipeline_config` / `get_pipeline_history`	Descobrir pipelines e ler sua configuração e histórico de versões.
`validate_pipeline_config`	Validar um YAML de configuração sem salvá-lo. Retorna `{valid, reason}`.
`save_pipeline_config`	Salvar o YAML completo da configuração como uma nova versão (não implanta).
`deploy_pipeline`	Implantar uma versão salva na frota.
`revert_pipeline`	Reverter para uma versão salva anteriormente.
`add_pipeline_source`	Adicionar um nó de fonte de dados a um pipeline.

Fluxo de edição típico: get_pipeline_config → editar YAML → validate_pipeline_config → save_pipeline_config → get_pipeline_history → deploy_pipeline (revert_pipeline para reverter).

Ferramentas de captura ao vivo

Validar que uma configuração é válida não é o mesmo que confirmar que uma alteração realmente transformou os dados. As ferramentas de captura ao vivo amostram dados reais de antes/depois que fluem pelos nós do pipeline em agentes em execução, para que um agente possa verificar se uma transformação teve efeito.

Ferramenta	O que faz
`start_pipeline_capture`	Iniciar uma tarefa de captura em um pipeline (duração, lista opcional de nós, itens máximos).
`get_pipeline_capture_status`	Consultar o status por agente de uma tarefa de captura.
`get_pipeline_capture_results`	Buscar amostras capturadas de antes/depois por nó.
`get_pipeline_capture_task`	Mostrar a tarefa de captura atualmente ativa, se houver.

Fluxo de captura: start_pipeline_capture → get_pipeline_capture_status (consultar até um agente relatar success) → get_pipeline_capture_results (comparar o before de cada nó vs after para confirmar a transformação).

Ferramentas de teste (dry-run) de processadores

Desenvolver e verificar um processador contra logs de amostra offline — sem salvar, sem implantar, sem tráfego ao vivo. O complemento offline da captura ao vivo: a captura prova o que aconteceu, isto prova o que acontecerá.

Ferramenta	O que faz
`test_pipeline_ottl`	Dry-run de instruções OTTL contra itens de log OTEL de amostra; retorna os itens transformados.
`test_pipeline_node`	Dry-run de um nó de processador completo de qualquer tipo (`log_to_metric`, `log_to_pattern`, `extract_metric`, `parse_json_attributes`, `grok`, `mask`, …); retorna os itens que ele emite por caminho de saída.

Itere até que a saída esteja correta, então adicione as instruções/nó ao pipeline, save_pipeline_config → deploy_pipeline, e confirme nos dados ao vivo com as ferramentas de captura. Use test_pipeline_ottl para transformações OTTL (seu ExtractPatterns também cobre extração de campos por regex); use test_pipeline_node para tipos de nós não-OTTL, como log-para-métrica e log-para-padrão.

Pré-requisitos

Docker Engine ≥ 20.10 instalado e em execução.

Plug-in Docker Buildx disponível:

macOS / Windows – incluído com o 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 …

Outras distribuições (fallback 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

Um token de API do Edge Delta com o escopo necessário – crie um aqui.
Seu ID de organização do Edge Delta – encontre-o aqui.

Build (imagem de contêiner)

Configuração inicial (cria um builder multi-plataforma e o inicia):

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

Construa a imagem e carregue-a no daemon Docker local:

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

ℹ️ A flag --load transmite a imagem de volta para o seu mecanismo Docker local para que você possa executá-la diretamente com docker run mcp/edgedelta ….

Instalação

Uso com 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 da Biblioteca

A API Go exportada deste módulo é experimental e pode mudar sem aviso prévio. Se você depender dela em produção, abra uma issue descrevendo seu caso de uso para que possamos estabilizar a superfície relevante.

Licença

Licenciado sob os termos da licença MIT. Consulte LICENSE para detalhes completos.