OpenTelemetry Model Context Protocol Instrumentation for Node.js

This module provides automatic instrumentation for the Model Context Protocol (MCP) SDK.

Installation

npm install --save @opentelemetry/instrumentation-mcp

Usage

import { NodeSDK } from '@opentelemetry/sdk-node';
import { MCPInstrumentation } from '@opentelemetry/instrumentation-mcp';

const sdk = new NodeSDK({
  instrumentations: [new MCPInstrumentation()],
});

sdk.start();

The instrumentation automatically patches the following MCP SDK components from @modelcontextprotocol/sdk:

• server.SSEServerTransport
• server.StdioServerTransport

Spans Created

For each transport type, the following spans are created with RPC attributes:

SSE Transport

• mcp.sse.message - When a message is received
  • Attributes: rpc.method, rpc.jsonrpc, rpc.id
• mcp.sse.error - When an error occurs
• mcp.sse.send - When a message is sent
  • Attributes: rpc.method, rpc.jsonrpc, rpc.id, rpc.related_id

Stdio Transport

• mcp.stdio.message - When a message is received
  • Attributes: rpc.method, rpc.jsonrpc, rpc.id
• mcp.stdio.error - When an error occurs
• mcp.stdio.send - When a message is sent
  • Attributes: rpc.method, rpc.jsonrpc, rpc.id, rpc.related_id

Configuration

The instrumentation has no configuration options at this time.

License

Apache 2.0 - See LICENSE for more information.