otel-mcp

Un servidor MCP que emite trazas, métricas y registros de OpenTelemetry a uno o más endpoints OTLP al mismo tiempo, en cualquiera de los tres formatos de transmisión OTLP:

• grpc — OTLP/gRPC (protobuf sobre HTTP/2)

• http/protobuf — OTLP/HTTP protobuf binario

• http/json — OTLP/HTTP proto3-JSON (compatible con la especificación)

También incluye perfiles de imitación de herramientas que producen paquetes de señales realistas con la forma de herramientas conocidas (nginx, postgres, redis, kafka, aws-lambda, pod de kubernetes, servicio gRPC genérico), para que pueda poblar un colector o backend con tráfico que parezca un entorno real.

Instalación

uv venv
uv pip install -e .

Related MCP server: Mock MCP Server

Ejecución

otel-mcp           # stdio transport — wire into any MCP client

O mediante una configuración de cliente MCP (por ejemplo, Claude Desktop, Claude Code):

{
  "mcpServers": {
    "otel": {
      "command": "otel-mcp"
    }
  }
}

Arranque de entorno

Si OTEL_EXPORTER_OTLP_ENDPOINT se establece al iniciar, se registra un endpoint llamado default utilizando las variables de entorno estándar de OTEL:

• OTEL_EXPORTER_OTLP_ENDPOINT

• OTEL_EXPORTER_OTLP_PROTOCOL (grpc | http/protobuf | http/json)

• OTEL_EXPORTER_OTLP_HEADERS (pares k=v separados por comas)

• OTEL_EXPORTER_OTLP_INSECURE (interruptor de TLS para gRPC)

Herramientas

Gestión de endpoints

Los endpoints se seleccionan por llamada: cada herramienta que emite señales acepta un argumento endpoints: [nombres]. Omítalo para distribuir la señal a todos los endpoints que acepten ese tipo de señal.

Emisión de señales sin procesar

Imitación

Perfiles integrados:

Sesión de ejemplo

> add_endpoint name="otel-collector" url="http://localhost:4318" protocol="http/protobuf"
> add_endpoint name="jaeger-json"    url="http://localhost:4318" protocol="http/json" signals=["traces"]
> mimic_tool profile="nginx" options={"count": 50, "error_rate": 0.1}
> mimic_tool profile="postgres"
> generate_load profile="kafka" iterations=10 interval_seconds=2
> send_trace service_name="checkout" spans=[
    {"name": "POST /checkout", "kind": "server", "duration_ms": 42, "attributes": {"http.response.status_code": 200}},
    {"name": "charge_card",    "kind": "client", "parent_name": "POST /checkout", "duration_ms": 18,
     "attributes": {"peer.service": "stripe"}}
  ]

Añadir un nuevo perfil de imitación

1. Escriba una función que devuelva un MimicBundle en src/otel_mcp/mimics.py.

2. Regístrela en el diccionario PROFILES al final de ese archivo.

3. Llame a list_mimic_profiles para confirmar que ha detectado los parámetros.

Los perfiles siguen siendo declarativos: cada uno devuelve especificaciones de span/métrica/registro que fluyen a través de la misma tubería de generación, por lo que heredan automáticamente la fusión de recursos correcta, el soporte de formato de transmisión y la distribución de señales.