🎯 MCP NUTRS Server

Servidor MCP (Model Context Protocol) para o ecossistema NUTRS - conecta Radar, Calendário e Cardápio ao Claude.

📊 Tools Disponíveis

Radar (10 tools)

Tool	Descrição
radar_dashboard	Visão executiva - ciclos recentes com métricas
radar_ciclo_detalhe	Drill-down de um ciclo: diários, itens, acréscimos, pedidos
radar_diarios	Dados dia a dia: planejado vs realizado
radar_acrescimos	Pedidos extras fora do planejamento
radar_economia	Relatório de savings nas negociações
radar_pedidos_compra	Ordens de compra com itens
radar_duplicatas	Financeiro: faturas e vencimentos
radar_recalcular_metricas	Atualizar cache de indicadores
radar_filiais	Lista de filiais/unidades
radar_alertas	Indicadores críticos e avisos

Calendário (3 tools)

Tool	Descrição
calendario_pendentes	Tarefas pendentes e atrasadas
calendario_semana	Agenda da semana por filial
calendario_stats	Estatísticas de conclusão

Cardápio (3 tools)

Tool	Descrição
cardapio_receitas	Catálogo de receitas com custos
cardapio_custo_filial	Orçamento por filial/dia
cardapio_estimar_proposta	Gerador de proposta comercial

🚀 Deploy

# 1. Clonar/copiar para o servidor
cp -r mcp-nutrs /opt/mcp-nutrs

# 2. Configurar .env
cp .env.example .env
nano .env  # preencher service key e senha do calendar

# 3. Build e run
cd /opt/mcp-nutrs
docker compose up -d --build

# 4. Testar
curl http://localhost:3100/health

# 5. Adicionar no Caddy (se usar Caddy)
# No Caddyfile adicionar:
# mcp.hubnutrs.com.br {
#   reverse_proxy mcp-nutrs:3100
# }

🔧 Conectar no Claude Desktop / Claude.ai

No Claude Desktop, adicionar no claude_desktop_config.json:

{
  "mcpServers": {
    "nutrs": {
      "url": "https://mcp.hubnutrs.com.br/mcp"
    }
  }
}

📁 Estrutura

mcp-nutrs/
├── src/
│   ├── index.ts              # Entry point + transport
│   ├── tools/
│   │   ├── radar.ts          # 10 tools do Radar
│   │   ├── calendario.ts     # 3 tools do Calendário
│   │   └── cardapio.ts       # 3 tools do Cardápio
│   ├── services/
│   │   ├── supabase.ts       # Cliente Supabase
│   │   ├── calendar-db.ts    # Cliente PostgreSQL
│   │   └── formatters.ts     # Helpers de formatação
│   └── schemas/              # (futuro: schemas Zod compartilhados)
├── Dockerfile
├── docker-compose.yml
├── package.json
├── tsconfig.json
└── .env.example

📐 Fontes de Dados

• Supabase (kknejnrlaonigduohwpe): tabelas rd-* (Radar) + receitas/custos (Cardápio)
• PostgreSQL (container nutrs-calendar-db): eventos, categorias, filiais (Calendário)