MCP Trace Store
joeyen-atscale/mcp-trace-store
Corpus de traces append-only para análise e fine-tuning de queries MQO
Ver no GitHubServidor MCP que implementa um armazenamento durável e append-only de traces de interações MQO (questão, resultado de bind, sinais de qualidade, resultado de execução) em formato JSONL. Sem dependências externas, com rotação automática de arquivos e tolerância a linhas corrompidas.
Instalação
npx convez-ai joeyen-atscale/mcp-trace-store1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Auditar e analisar histórico de interações MQO em produção
- Exportar dados de qualidade e performance para fine-tuning de modelos
- Minerar gaps entre intent e grounding via corpus persistente
- Debugar e otimizar bind outcomes e execute results
Veredito

MCP server robusto e minimalista para coleta estruturada de traces de queries. Ideal para times que precisam auditar, debugar ou treinar modelos baseado em interações reais, sem overhead de banco de dados externo.
README
A tradução para o português deste README ainda está na fila.
mcp-trace-store
Durable, append-only interaction trace store for MQO queries.
Every MQO interaction — the question, the bind result, the grounding score, the execute result — is stored as a JSONL record. The corpus powers the gap miner, quality scorer, and fine-tuning exporter.
Overview
- Format: JSONL, one record per line, append-only
- Rotation: Active file at
<path>; rotated to<path>.1,<path>.2, etc. whenrotate_at_bytesis exceeded - Atomic writes: Uses
O_APPENDfor single-syscall atomicity per POSIX - Corrupt-line tolerance: Corrupt or truncated lines are skipped with a warning to stderr; prior records are never affected
- No external deps: No database, no network, no async
Usage
use mcp_trace_store::{
BindOutcome, ExecuteOutcome, QualitySignals,
TraceFilter, TraceRecord, TraceStore, TraceStoreConfig,
};
let cfg = TraceStoreConfig::new("~/.local/share/mcp-traces/trace.jsonl");
let store = TraceStore::new(cfg)?;
let record = TraceRecord::new(
"session-abc",
serde_json::json!({"entity": "Revenue"}),
BindOutcome::Success,
ExecuteOutcome::Success { row_count: 10, result_empty: false },
QualitySignals {
first_attempt_bind: true,
bind_attempt_count: 1,
total_latency_ms: 42,
tokens_used: None,
},
);
store.append(record)?;
// Query with filter
let filter = TraceFilter {
first_attempt_only: true,
..TraceFilter::default()
};
let results = store.scan(&filter)?;
Core types
| Type | Purpose |
|---|---|
TraceRecord | Single persisted interaction |
BindOutcome | Success / Ambiguous / NotFound / Error(String) |
GroundingBand | Grounded / Partial / Ungroundable |
ExecuteOutcome | Success { row_count, result_empty } / Error(String) / Skipped |
QualitySignals | first_attempt_bind, bind_attempt_count, total_latency_ms, tokens_used |
TraceFilter | Time range, grounding band, first-attempt, cluster, session, limit |
TraceStore | append, scan, count, rotate_if_needed |
File layout
<path> ← active file (newest writes)
<path>.1 ← previous rotation (older)
<path>.2 ← two rotations ago (oldest)
scan reads fragments oldest-first (<path>.N descending, then <path>).
Acceptance criteria
All 7 ACs pass under cargo test (AC7 timing SLO enforced in --release only):
| AC | Description |
|---|---|
| AC1 | append creates file and writes valid JSON lines |
| AC2 | scan filters by grounding_band correctly |
| AC3 | scan with first_attempt_only filters correctly |
| AC4 | Corrupt/partial line in JSONL does not break scan |
| AC5 | Rotation works; scan reads both fragments in order |
| AC6 | Missing optional fields → None; unknown fields ignored |
| AC7 | 10k append+scan completes in < 2s (release build) |
License
MIT OR Apache-2.0