Tempo

Tempo

An MCP server to query traces/spans from Grafana Tempo.

17
Stars
4
Forks
0
Releases

Overview

This Tempo MCP Server is a Go-based implementation of the Model Context Protocol (MCP) with native Grafana Tempo integration. It enables AI assistants and workflow tools to query and analyze distributed tracing data stored in Tempo using MCP tools defined by the server. The server follows the MCP specification to expose Tempo-specific tooling, notably the tempo_query tool, which accepts a required Tempo query string and optional connection details such as Tempo URL, time range, result limit, and authentication credentials. The server supports two modes of operation: a standard MCP interaction over stdin/stdout and an HTTP server that exposes a Server-Sent Events (SSE) endpoint for real-time streaming and an MCP endpoint for protocol messaging. The default HTTP port is 8080, configurable via the SSE_PORT environment variable. It can be built and run locally using Go or Docker, with a Dockerfile and optional Docker Compose for a complete test environment. The project includes testing support (run-client.sh) and is designed to integrate with Claude Desktop, Cursor, and n8n through configured MCP servers. Example configurations show how to expose tempo_query for Claude Desktop and other tooling to interact with Tempo data.

Details

Owner
scottlepp
Language
Go
License
Updated
2025-12-07

Features

Tempo Query Tool

tempo_query allows querying Grafana Tempo traces using a Tempo query string; supports optional url, start, end, limit, and authentication parameters.

Dual MCP Communication Modes

Operates via standard MCP over stdin/stdout and via an HTTP SSE-enabled server for real-time interactions.

HTTP Endpoints

Provides an SSE endpoint (/sse) for streaming and an MCP endpoint (/mcp) for MCP protocol messaging.

Docker and Docker Compose

Docker build/run support with an optional Docker Compose setup for a complete test environment.

Claude Desktop Integration

Includes configuration examples to expose tempo_query to Claude Desktop and integrate with MCP workflows.

n8n Integration

Supports using the MCP Client Tool node in n8n to connect to the SSE endpoint and drive AI agents.

Cursor Integration

Cursor-friendly configuration snippets to wire the Tempo MCP Server into Cursor workflows.

Audience

AI agentsQuery Tempo traces and perform analysis through MCP-enabled tools during conversations.
Developers / integratorsRun and integrate Tempo MCP Server with Claude Desktop, Cursor, and n8n workflows.
Tempo operators / tracing teamsLeverage MCP tools to fetch and inspect Grafana Tempo traces for troubleshooting.

Tags

tempografana tempomcptempo_querytracingaiclaude desktopn8ncursordockersseendpoints