Advertise
MCP.so
Sign In

Jaeger MCP Server

@serkan-ozal

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

serkan-ozal

About Jaeger MCP Server

MCP Server for Jaeger

Jaeger MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "jaeger-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "jaeger-mcp-server"
      ],
      "env": {
        "JAEGER_URL": "<YOUR_JAEGER_HTTP_OR_GRPC_API_URL>"
      }
    }
  }
}

Jaeger MCP Server tools

4

Gets the operations as JSON array of object with `name` and `spanKind` properties.

Gets the service names as JSON array of string.

Gets the spans by the given trace by ID as JSON array of object in the OpenTelemetry resource spans format.

Searches the spans as JSON array of object in the OpenTelemetry resource spans format.

Overview

What is Jaeger MCP Server?

Jaeger MCP Server is a Model Context Protocol (MCP) server that provides MCP-compatible tools for querying and retrieving distributed tracing data from a Jaeger instance. It is intended for developers using MCP-capable AI assistants (such as VS Code, Claude, Cursor, Windsurf, or GitHub Copilot) who need to inspect traces, services, and operations within their Jaeger deployment.

How to use Jaeger MCP Server?

Add the server to your MCP client’s configuration using the npx -y jaeger-mcp-server command. Configure the mandatory JAEGER_URL environment variable (plus optional JAEGER_PORT, JAEGER_PROTOCOL, or JAEGER_AUTHORIZATION_HEADER) either via an env block or an env file. The server uses STDIO transport and requires Node.js 18 or higher.

Key features of Jaeger MCP Server

  • Retrieves Jaeger service names and operation names.
  • Fetches an entire trace by its 32-character hexadecimal trace ID.
  • Searches for traces with filters on service, operation, attributes, time windows, and duration.
  • Supports both Jaeger HTTP JSON API (/api/v3/*) and gRPC/Protobuf API (jaeger.api_v3.QueryService).
  • Easy integration with any MCP client via a single NPM command.

Use cases of Jaeger MCP Server

  • Debug a production incident by asking an AI assistant to fetch a specific trace ID from Jaeger.
  • Explore which services and operations exist in your distributed system without switching tools.
  • Filter and find traces by custom span attributes (strings, numbers, booleans) to isolate problematic requests.
  • Query traces within a precise time range to correlate with deployment or alert windows.

Frequently asked questions

1

What prerequisites are needed?

Node.js 18 or later must be installed on the machine running the MCP client.

2

How do I configure the Jaeger connection?

Set the `JAEGER_URL` environment variable to your Jaeger HTTP or gRPC API endpoint. Optionally set `JAEGER_PORT`, `JAEGER_PROTOCOL` (defaults to GRPC), or `JAEGER_AUTHORIZATION_HEADER`.

3

What tools does the server expose?

It exposes four tools: `get-services`, `get-operations`, `get-trace`, and `find-traces`. Each can be called by the MCP client with the documented input parameters.

4

Does it support both HTTP and gRPC transport?

Yes. You can choose between HTTP JSON (`/api/v3/*`) and gRPC/Protobuf (`jaeger.api_v3.QueryService`) protocols by setting the `JAEGER_PROTOCOL` environment variable to `HTTP` or `GRPC`.

5

Where can I report issues or contribute?

Issues and pull requests are handled on the project’s GitHub repository at `serkan-ozal/jaeger-mcp-server`. The project is licensed under MIT.

Comments

More Other MCP servers

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

ICSS

chokcoco

不止于 CSS

20.7K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K
Advertise