Jaeger MCP Server logo

Jaeger MCP Server

by serkan-ozal

Jaeger MCP Server is an MCP server for Jaeger, enabling integration with MCP clients like VS Code, Claude, and Cursor. It allows querying Jaeger traces and services through a standardized interface.

View on GitHub

Last updated: N/A

What is Jaeger MCP Server?

Jaeger MCP Server is a server that provides a standardized interface (using the MCP protocol) for querying Jaeger tracing data. It allows MCP clients to access Jaeger's services, operations, and traces.

How to use Jaeger MCP Server?

The server can be added to MCP clients like VS Code, Claude, and Cursor by configuring the client to use the jaeger-mcp-server NPM package. The configuration typically involves specifying the command to run the server (e.g., npx jaeger-mcp-server) and setting environment variables like JAEGER_URL to point to the Jaeger instance.

Key features of Jaeger MCP Server

  • Provides a standardized MCP interface for Jaeger

  • Supports querying services, operations, and traces

  • Compatible with various MCP clients (VS Code, Claude, Cursor)

  • Configurable via environment variables

  • Supports HTTP and gRPC protocols for Jaeger API access

Use cases of Jaeger MCP Server

  • Integrating Jaeger tracing data into IDEs and other development tools

  • Providing a consistent interface for querying Jaeger across different environments

  • Enabling advanced tracing analysis within MCP clients

  • Automating tracing workflows through MCP

  • Extending the functionality of MCP clients with Jaeger tracing capabilities

FAQ from Jaeger MCP Server

What is the purpose of the JAEGER_URL environment variable?

The JAEGER_URL environment variable specifies the HTTP or gRPC API URL of the Jaeger instance that the MCP server will connect to.

What protocols are supported for accessing the Jaeger API?

The server supports both HTTP and gRPC protocols for accessing the Jaeger API. The protocol can be specified using the JAEGER_PROTOCOL environment variable.

How can I filter traces by attributes?

The find-traces tool allows filtering spans by attributes. Attributes can be passed in key/value format in JSON where keys can be string and values can be string, number (integer or double) or boolean.

What is the difference between startTimeMin and startTimeMax in the find-traces tool?

startTimeMin defines the start of the time interval (inclusive), while startTimeMax defines the end of the time interval (exclusive) for the query. Only traces with spans that started on or after startTimeMin and before startTimeMax will be returned.

What is the purpose of the searchDepth parameter in the find-traces tool?

The searchDepth parameter defines the maximum search depth. Depending on the backend storage implementation, this may behave like an SQL LIMIT clause.