convez.ai
MCP ServerDados & AnalyticsAvançado
joeyen-atscale

MCP Trace Store

joeyen-atscale/mcp-trace-store

Corpus de traces append-only para análise e fine-tuning de queries MQO

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-store

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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. when rotate_at_bytes is exceeded
  • Atomic writes: Uses O_APPEND for 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

TypePurpose
TraceRecordSingle persisted interaction
BindOutcomeSuccess / Ambiguous / NotFound / Error(String)
GroundingBandGrounded / Partial / Ungroundable
ExecuteOutcomeSuccess { row_count, result_empty } / Error(String) / Skipped
QualitySignalsfirst_attempt_bind, bind_attempt_count, total_latency_ms, tokens_used
TraceFilterTime range, grounding band, first-attempt, cluster, session, limit
TraceStoreappend, 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):

ACDescription
AC1append creates file and writes valid JSON lines
AC2scan filters by grounding_band correctly
AC3scan with first_attempt_only filters correctly
AC4Corrupt/partial line in JSONL does not break scan
AC5Rotation works; scan reads both fragments in order
AC6Missing optional fields → None; unknown fields ignored
AC710k append+scan completes in < 2s (release build)

License

MIT OR Apache-2.0

Ver o original no GitHub

Bom para

Relacionados