Python · Instrumentation
openinference-instrumentation-mcp
OpenInference MCP Instrumentation
- Module
openinference.instrumentation.mcp- Version
- 2.1.5
- Python
- >=3.10, <3.16
- Instruments
mcp >= 1.24.0
Install
pip install openinference-instrumentation-mcpUsage
Instrument once, at startup, before the library is used. The MCPInstrumentor reference below lists the options.
from opentelemetry.sdk.trace import TracerProvider
from openinference.instrumentation.mcp import MCPInstrumentor
tracer_provider = TracerProvider()
# ...add a span processor that exports to Phoenix or any OTLP backend.
MCPInstrumentor().instrument(tracer_provider=tracer_provider)openinference.instrumentation.mcp
MCPInstrumentor
classSource ↗class MCPInstrumentor(BaseInstrumentor)An instrumenter for MCP.
instrument
methoddef instrument(
*,
tracer_provider: Optional[TracerProvider] = None,
skip_dep_check: bool = False,
) -> NoneStart tracing mcp: patch it so its calls make OpenInference spans. Calling it again does nothing. Inherited from OpenTelemetry’s BaseInstrumentor.
Parameters
| Name | Description |
|---|---|
tracer_provider | The tracer provider the spans are made with. Defaults to the global one, |
skip_dep_check | Instrument even if the installed version of |
uninstrument
methoddef uninstrument() -> NoneStop tracing: undo the patches instrument() made. Inherited from OpenTelemetry’s BaseInstrumentor.
instrumentation_dependencies
methodSource ↗def instrumentation_dependencies() -> Collection[str]InstrumentedStreamReader
classSource ↗class InstrumentedStreamReader(ObjectProxy)Attributes
| Name | Type and value |
|---|---|
last_context | contextvars.Context | NoneContext snapshot used by the MCP 2.0 dispatcher for spawned handlers. |
InstrumentedStreamWriter
classSource ↗class InstrumentedStreamWriter(ObjectProxy)ItemWithContext
dataclassSource ↗class ItemWithContext(item: Any, ctx: context.Context)ContextSavingStreamWriter
classSource ↗class ContextSavingStreamWriter(ObjectProxy)ContextAttachingStreamReader
classSource ↗class ContextAttachingStreamReader(ObjectProxy)