MCP OTel
W3C-Trace-Context-Brücke für das Model Context Protocol
Implementiert MCP-Spec SEP-414: propagiert traceparent / tracestate / baggage aus _meta als OpenTelemetry-Spans, sodass Host → Server → Tool → Downstream als ein Trace-Baum erscheint. Drop-in für jeden MCP-Server, kein Vendor-Lock-in. 41 Tests, MIT, TypeScript.
Welches Problem es löst
Eine Anfrage, die von einem Wirt über einen MCP-Server in ein Werkzeug und weiter in einen HTTP-Aufruf läuft, sollte als eine zusammenhängende Spur erscheinen. Stattdessen erscheint sie als vier unabhängige, weil niemand den Spurkontext über den MCP-Sprung getragen hat.
Wie es arbeitet
Der Freigabekandidat vom 28.07.2026 hat geklärt, wo dieser Kontext liegt: SEP-414 reserviert die Meta-Schlüssel traceparent, tracestate und baggage ohne Präfix für W3C Trace Context und W3C Baggage, und Transporte müssen sie unangetastet durchreichen. SEP-2577 hat die Protokollierungs-Fähigkeit von MCP als veraltet erklärt und stattdessen auf OpenTelemetry gezeigt. Diese Bibliothek legt die Rohre, die aus beidem folgen: sie liest den Aufrufer-Kontext aus dem Meta-Feld, startet für den Werkzeugaufruf eine korrekt eingehängte OpenTelemetry-Spanne und lässt deine nachgelagerten Aufrufe daran hängen.
Wann du es nimmst
Nimm es, wenn du OpenTelemetry ohnehin betreibst und der MCP-Sprung die Lücke in deinen Spuren ist. Es erscheint als eine zusammenhängende Spur in Jaeger, Tempo, Honeycomb oder Datadog, ohne dass du an deinem bestehenden Export etwas änderst, denn es fasst nur den Kontext an und sonst nichts.
Wann du es nicht nimmst
Es ist bewusst dünn, und das schneidet in beide Richtungen. Es richtet OpenTelemetry nicht für dich ein, es bringt keinen Exporter mit und es versteckt deinen Tracer nicht, wer also auf Beobachtbarkeit in einer Installation gehofft hat, ist hier falsch. Du behältst die Kontrolle über Stichproben, Ressourcen und Exporte, und das hier überbrückt nur das Meta-Feld zu den Spannen.
Stars
★ 0
installs
↓ 385
Clones (14d)
⊟ 30
Sprache
TypeScript
Aktualisiert
2026-08-15
Installation
npx -y mcp-otel