MCP Next Query Proposer
joeyen-atscale/mcp-next-query-proposer
Propostas analíticas determinísticas por traversal de grafos de entidades
Ver no GitHubMotor 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-proposer1 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
- 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
| Flag | Description | Default |
|---|---|---|
--session | SessionState JSON (mqo_history + touched_entities) | required |
--model | describe_model JSON (measures + hierarchies with levels) | required |
--last-handle | DatasetSummary JSON (per-column stats including distinct) | required |
--count | Max proposals to return (clamped to 5) | 3 |
--strategy | drill, compare, pivot, or auto | auto |
--format | json or human | json |
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
| Strategy | When (auto) | What it does |
|---|---|---|
drill | Last handle has a column with distinct > 10 AND unvisited child levels exist | Deepens one level in the current dimension hierarchy |
compare | No time_intelligence in prior MQOs AND model has a time dimension | Adds prior_period (and optionally YoY) time_intelligence |
pivot | Otherwise | Swaps 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/