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

MCP Next Query Proposer

joeyen-atscale/mcp-next-query-proposer

Propostas analíticas determinísticas por traversal de grafos de entidades

Ver no GitHub
InicialPluginScore · de 0 a 100

Motor determinístico de traversal de grafos que propõe follow-up queries analíticas (MQOs) a partir do contexto de sessão e adjacência de entidades. Gera sugestões tipadas e prontas para execução — sem LLM, sem rede, apenas lógica determinística de graph-traversal.

Instalação

$npx convez-ai joeyen-atscale/mcp-next-query-proposer

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

  • Sugerir drill-down automático em dimensões com alta cardinalidade
  • Propor comparações temporais (período anterior, YoY) sem LLM
  • Recomendar pivots entre dimensões adjacentes não visitadas
  • Acelerar exploração analítica com MQOs tipadas e bound-ready

Veredito

Ferramenta especializada para pipelines de BI/analytics que precisam de proposição automática de queries sem overhead de LLM. Excelente para acelerar explorações iterativas em modelos dimensionais, mas requer integração forte com sessão e metadados de modelo — não é plug-and-play.

README

A tradução para o português deste README ainda está na fila.

mcp-next-query-proposer

Propose analytically valuable follow-up MQOs from session context.

When an agent asks "revenue by region," the obvious follow-up questions are "drill into the highest region," "compare to prior period," and "break down by product category." This CLI reads the session state and the model's entity adjacency graph and proposes the top N follow-up MQOs as typed, bound-ready objects — not natural language suggestions, but actual MQOs the agent can submit directly to query_multidimensional.

No LLM, no network — proposals are deterministic graph-traversal outputs.

Usage

mcp-next-query-proposer \
  --session   session.json     \
  --model     describe.json    \
  --last-handle summary.json   \
  [--count 3]                  \
  [--strategy drill|compare|pivot|auto] \
  [--format json|human]

Arguments

FlagDescriptionDefault
--sessionSessionState JSON (mqo_history + touched_entities)required
--modeldescribe_model JSON (measures + hierarchies with levels)required
--last-handleDatasetSummary JSON (per-column stats including distinct)required
--countMax proposals to return (clamped to 5)3
--strategydrill, compare, pivot, or autoauto
--formatjson or humanjson

Output

{
  "session_id": "abc-123",
  "proposals": [
    {
      "rank": 1,
      "strategy": "drill",
      "rationale": "High cardinality on 'Store Region'; drill to 'Store State'",
      "mqo": {
        "model": "sales",
        "measures": [{"unique_name": "sales.revenue"}],
        "dimensions": [{"hierarchy": "geo.store", "level": "Store State"}],
        "filters": [],
        "time_intelligence": []
      }
    }
  ]
}

Input shapes

session.json

{
  "session_id": "abc-123",
  "mqo_history": [
    {
      "mqo": {
        "model": "sales",
        "measures": [{"unique_name": "sales.revenue"}],
        "dimensions": [{"hierarchy": "geo.store", "level": "Store Region"}],
        "filters": [],
        "time_intelligence": []
      }
    }
  ],
  "touched_entities": ["sales.revenue", "geo.store.Store Region"]
}

describe.json

{
  "measures": [
    {"unique_name": "sales.revenue", "label": "Revenue"}
  ],
  "hierarchies": [
    {
      "unique_name": "geo.store",
      "is_time": false,
      "levels": [
        {"unique_name": "geo.store.Store Region", "name": "Store Region", "depth": 1},
        {"unique_name": "geo.store.Store State",  "name": "Store State",  "depth": 2}
      ]
    },
    {
      "unique_name": "time.calendar",
      "is_time": true,
      "levels": [
        {"unique_name": "time.calendar.Year", "name": "Year", "depth": 1}
      ]
    }
  ]
}

summary.json (DatasetSummary)

{
  "row_count": 500,
  "columns": [...],
  "sample": [],
  "sample_cap": 20,
  "stats": {
    "geo.store.Store Region": {"distinct": 52, ...}
  },
  "notes": []
}

Strategy logic

StrategyWhen (auto)What it does
drillLast handle has a column with distinct > 10 AND unvisited child levels existDeepens one level in the current dimension hierarchy
compareNo time_intelligence in prior MQOs AND model has a time dimensionAdds prior_period (and optionally YoY) time_intelligence
pivotOtherwiseSwaps or adds an adjacent unvisited dimension from the frontier

Building

cargo build --release
# Binary at: target/release/mcp-next-query-proposer

Testing

cargo test
# 24 integration tests covering AC1–AC7

Install

cp target/release/mcp-next-query-proposer ~/.local/bin/
Ver o original no GitHub

Bom para

Relacionados