MCP OTel
Puente de W3C Trace Context para el Model Context Protocol
Implementa la spec MCP SEP-414: propaga traceparent / tracestate / baggage desde _meta como spans de OpenTelemetry, para que host → servidor → tool → downstream se vea como un único árbol de traza. Drop-in para cualquier servidor MCP, sin vendor lock-in. 41 tests, MIT, TypeScript.
Qué problema resuelve
Una petición que va de un anfitrión a un servidor MCP, de ahí a una herramienta y luego a una llamada HTTP posterior debería aparecer como una sola traza conectada. En su lugar aparece como cuatro sueltas, porque nadie llevaba el contexto de traza a través del salto MCP.
Cómo funciona
El candidato a versión del 28-07-2026 dejó claro dónde vive ese contexto: SEP-414 reserva las claves meta sin prefijo traceparent, tracestate y baggage para W3C Trace Context y W3C Baggage, y los transportes deben pasarlas intactas. SEP-2577 marcó como obsoleta la capacidad de registro de MCP y señaló a OpenTelemetry en su lugar. Esta biblioteca pone la fontanería que se deriva de ambas: lee el contexto de quien llama desde el campo meta, arranca un span de OpenTelemetry correctamente anidado para la llamada a la herramienta y deja que tus llamadas posteriores cuelguen de él.
Cuándo usarlo
Cógelo cuando ya usas OpenTelemetry y el salto MCP es el hueco en tus trazas. Aparece como una sola traza conectada en Jaeger, Tempo, Honeycomb o Datadog sin que cambies cómo exportas ya, porque solo toca el contexto y nada más.
Cuándo no usarlo
Es deliberadamente delgada, y eso corta en ambos sentidos. No configura OpenTelemetry por ti, no trae exportador y no esconde tu tracer, así que si esperabas observabilidad en una sola instalación, no es esto. Tú conservas el control del muestreo, los recursos y los exportadores, y esto solo tiende el puente entre el campo meta y los spans.
Stars
★ 0
installs
↓ 385
Clones (14d)
⊟ 30
Lenguaje
TypeScript
Actualizado
2026-08-15
Instalación
npx -y mcp-otel