otel-mcp

Ein MCP-Server, der OpenTelemetry-Traces, -Metriken und -Logs gleichzeitig an einen oder mehrere OTLP-Endpunkte sendet, und zwar in einem der drei OTLP-Wire-Formate:

• grpc — OTLP/gRPC (Protobuf über HTTP/2)

• http/protobuf — OTLP/HTTP binäres Protobuf

• http/json — OTLP/HTTP proto3-JSON (spezifikationskonform)

Er enthält außerdem Profile zur Werkzeug-Nachahmung, die realistische Signalbündel erzeugen, die wie bekannte Tools geformt sind (Nginx, Postgres, Redis, Kafka, AWS-Lambda, Kubernetes-Pod, generischer gRPC-Dienst), sodass Sie einen Collector oder ein Backend mit Datenverkehr füllen können, der wie eine echte Umgebung aussieht.

Installation

uv venv
uv pip install -e .

Related MCP server: Mock MCP Server

Ausführung

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

Oder über eine MCP-Client-Konfiguration (z. B. Claude Desktop, Claude Code):

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

Env-Bootstrap

Wenn OTEL_EXPORTER_OTLP_ENDPOINT beim Start gesetzt ist, wird ein Endpunkt namens default unter Verwendung der Standard-OTEL-Umgebungsvariablen registriert:

• OTEL_EXPORTER_OTLP_ENDPOINT

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

• OTEL_EXPORTER_OTLP_HEADERS (durch Kommas getrennte k=v-Paare)

• OTEL_EXPORTER_OTLP_INSECURE (gRPC TLS-Umschalter)

Tools

Endpunkt-Verwaltung

Endpunkte werden pro Aufruf ausgewählt: Jedes signalgebende Tool akzeptiert ein endpoints: [names]-Argument. Wenn Sie es weglassen, wird das Signal an alle Endpunkte gesendet, die diesen Signaltyp akzeptieren.

Rohsignal-Emission

Nachahmung (Mimicry)

Integrierte Profile:

Beispiel-Sitzung

> 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"}}
  ]

Hinzufügen eines neuen Nachahmungsprofils

1. Schreiben Sie eine Funktion, die ein MimicBundle in src/otel_mcp/mimics.py zurückgibt.

2. Registrieren Sie sie im PROFILES-Dictionary am Ende dieser Datei.

3. Rufen Sie list_mimic_profiles auf, um zu bestätigen, dass die Parameter übernommen wurden.

Profile bleiben deklarativ: Jedes gibt Span-/Metrik-/Log-Spezifikationen zurück, die durch dieselbe Generator-Pipeline fließen, sodass sie automatisch die korrekte Ressourcen-Zusammenführung, Wire-Format-Unterstützung und Fan-Out erben.