{"id":27316924,"url":"https://github.com/scottlepp/tempo-mcp-server","last_synced_at":"2025-06-17T05:41:54.509Z","repository":{"id":287467593,"uuid":"964695585","full_name":"scottlepp/tempo-mcp-server","owner":"scottlepp","description":"An MCP ( Model Context Protocol ) Server for Grafana Tempo","archived":false,"fork":false,"pushed_at":"2025-04-11T21:37:41.000Z","size":12624,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-11T22:34:59.703Z","etag":null,"topics":["agentic-ai","agentic-workflow","ai","go","golang","grafana","grafana-tempo","mcp","mcp-server","tempo"],"latest_commit_sha":null,"homepage":"https://github.com/grafana/tempo","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/scottlepp.png","metadata":{"files":{"readme":"README-TRACES.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-11T16:24:49.000Z","updated_at":"2025-04-11T21:37:44.000Z","dependencies_parsed_at":"2025-04-11T22:45:20.591Z","dependency_job_id":null,"html_url":"https://github.com/scottlepp/tempo-mcp-server","commit_stats":null,"previous_names":["scottlepp/tempo-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scottlepp%2Ftempo-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scottlepp%2Ftempo-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scottlepp%2Ftempo-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scottlepp%2Ftempo-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/scottlepp","download_url":"https://codeload.github.com/scottlepp/tempo-mcp-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248542903,"owners_count":21121826,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","agentic-workflow","ai","go","golang","grafana","grafana-tempo","mcp","mcp-server","tempo"],"created_at":"2025-04-12T08:38:59.765Z","updated_at":"2025-04-12T08:39:00.441Z","avatar_url":"https://github.com/scottlepp.png","language":"Go","funding_links":[],"categories":["📊 Monitoring","📡 Monitoring \u0026 Observability"],"sub_categories":[],"readme":"# Tempo Trace Generator and Query Tools\n\nThis directory contains tools for generating test traces in Tempo and querying them through the MCP server.\n\n## Setup\n\n1. **Start Tempo and Grafana:**\n   ```\n   docker-compose -f docker-compose.test.yml up -d\n   ```\n\n   This starts:\n   - Tempo on port 3200 (HTTP API)\n   - Tempo on port 4317 (OTLP gRPC receiver)\n   - Grafana on port 3000\n\n2. **Generate trace data:**\n   ```\n   ./insert-example-traces.sh\n   ```\n\n   By default, it generates 10 traces spread across several services.\n   You can configure:\n   - `NUM_TRACES=20 ./insert-example-traces.sh` (change trace count)\n   - `SERVICE_NAMES=\"service1,service2\" ./insert-example-traces.sh` (custom service names)\n\n3. **Query traces using the MCP server:**\n   ```\n   ./run-client.sh tempo_query \"{service.name=\\\"frontend\\\"}\"\n   ```\n\n   Other useful queries:\n   - `./run-client.sh tempo_query \"{duration\u003e100ms}\"`\n   - `./run-client.sh tempo_query \"{service.name=\\\"backend\\\"}\"`\n   - `./run-client.sh tempo_query \"{status.code=error}\"`\n\n## Trace Generator\n\nThe trace generator is a Go program that creates realistic distributed traces:\n\n- Creates spans for multiple services (frontend, backend, database, etc.)\n- Adds parent-child relationships between spans\n- Includes errors in some spans (20% chance per child span)\n- Simulates different operation types (compute, io, network, database, external)\n- Sets appropriate attributes on spans\n- Creates distributed traces that span multiple services\n\n## Visual UI\n\nYou can access the Grafana UI at http://localhost:3000 to visually explore the traces.\nTempo should be pre-configured as a data source.\n\n## Troubleshooting\n\n1. **Cannot connect to Tempo:**\n   The script will automatically run in Docker if Tempo is detected in Docker. Otherwise,\n   it will try to connect to the host directly.\n\n2. **No traces appear:**\n   Check Tempo logs:\n   ```\n   docker-compose -f docker-compose.test.yml logs tempo\n   ```\n\n3. **MCP server error:**\n   Make sure to build the MCP server: `go build -o tempo-mcp-server cmd/server/main.go` ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscottlepp%2Ftempo-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscottlepp%2Ftempo-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscottlepp%2Ftempo-mcp-server/lists"}