Summary

Trace search that fits in one sentence.

Asking "show me traces over a second in the frontend service" and getting them back is the entire product. Because the endpoint lives in the environment and the time range defaults to the last hour, the first useful call needs nothing but the selector.

What it is

A Go MCP server that lets an assistant search distributed traces in Grafana Tempo. It follows the same shape as its sibling for Loki — one focused query tool, connection details in configuration rather than in every prompt.

What you get

`tempo_query` — takes a Tempo query string such as a service selector or a duration filter, plus optional URL, start, end and limit
Defaults that keep a first call cheap: the last hour, and a small cap on traces returned
Optional per-call authentication — username and password, or a bearer token
Two transports: stdio for local clients, or an HTTP server exposing /sse and /mcp for automation tools
A docker-compose environment for trying it against a local Tempo

Requirements

A reachable Tempo instance, and Go 1.21 or higher to build (`go build ./cmd/server`), or the provided Docker image. TEMPO_URL sets the default endpoint; SSE_PORT changes the HTTP port, which is 8080 by default. Docker and Docker Compose are needed only for the bundled local test environment. MIT licensed.

Setup effort

Build from source — clone the repository and build it, then point your client at the binary