Claude Desktop / Terminal
        │
        ▼
   MCP Server (Python)
        │
        ├── Tool: create_measure()    ──► Claude API ──► DAX gerado
        ├── Tool: explain_measure()   ──► Claude API ──► Documentação
        ├── Tool: suggest_kpis()      ──► Claude API ──► Lista de KPIs
        ├── Tool: create_calendar()   ──► Claude API ──► dCalendario DAX
        ├── Tool: organize_measures() ──► Claude API ──► Estrutura de pastas
        └── Tool: document_model()    ──► Claude API ──► README do modelo
                                              │
                                     Resultado colado no
                                     Power BI Desktop

powerbi-ai-mcp/
│
├── data/
│   └── vendas.csv              # Dataset de vendas (60 registros, 6 meses)
│
├── scripts/
│   ├── mcp_server.py           # Servidor MCP com todas as ferramentas de IA
│   ├── medidas_dax.dax         # Medidas geradas pela IA (25+ medidas)
│   └── dCalendario.dax         # Tabela Calendário PT-BR completa
│
├── docs/
│   └── arquitetura.png         # Diagrama da solução
│
├── requirements.txt
└── README.md

Receita Total = SUM(Vendas[Valor_Venda])

Lucro = [Receita Total] - [Custo Total]

Margem % = DIVIDE([Lucro], [Receita Total], 0)

Ticket Médio = DIVIDE([Receita Total], [Total Pedidos], 0)

Crescimento MoM % =
DIVIDE(
    [Receita Total] - [Receita MêsAnterior],
    [Receita MêsAnterior],
    0
)

Crescimento YoY % =
DIVIDE(
    [Receita Total] - [Receita MesmoPeríodo AA],
    [Receita MesmoPeríodo AA],
    0
)

Rank Produto Receita =
RANKX(ALL(Vendas[Produto]), [Receita Total],, DESC, DENSE)

# Clone o repositório
git clone https://github.com/r9drig-tech/powerbi-ai-mcp
cd powerbi-ai-mcp

# Crie e ative o ambiente virtual
python -m venv .venv
source .venv/bin/activate        # Linux/Mac
.venv\Scripts\activate           # Windows

# Instale as dependências
pip install -r requirements.txt

# Configure sua chave de API
echo "ANTHROPIC_API_KEY=sk-ant-..." > .env

python scripts/mcp_server.py

você > Crie uma medida de Receita Total usando a coluna Valor_Venda

IA  > **Receita Total**

    ```dax
    Receita Total =
    SUM(Vendas[Valor_Venda])
    ```

    Soma todos os valores da coluna Valor_Venda da tabela Vendas.
    Pasta sugerida: 💰 Financeiro

você > Crie uma medida de Margem de Lucro em percentual

IA  > **Margem %**

    ```dax
    Margem % =
    DIVIDE(
        [Lucro],
        [Receita Total],
        0
    )
    ```

    Calcula a margem de lucro como proporção da receita.
    Usa DIVIDE() para evitar erro de divisão por zero.
    Pasta sugerida: 💰 Financeiro

você > Sugira KPIs para um dashboard executivo de vendas

IA  > **KPIs para Dashboard Executivo — Vendas**

    🔴 P1 — Críticos
    • Receita Total | SUM(Vendas[Valor_Venda])
    • Margem % | DIVIDE([Lucro],[Receita Total])
    • Crescimento MoM % | variação vs mês anterior

    🟡 P2 — Importantes
    • Ticket Médio | Receita / Nº de pedidos
    • Top 10 Produtos | RANKX por receita
    • Receita por Região | segmentação geográfica

    🟢 P3 — Complementares
    • Receita Acumulada no Ano (YTD)
    • Crescimento YoY %
    • Taxa de Retorno de Clientes