Calculadora de Combustivel

Servidor MCP (Model Context Protocol) para calcular qual combustivel abastecer com base nos precos e rendimento real.

Sobre

Este servidor MCP roda na Cloudflare Workers e pode ser integrado com:

• ChatGPT (via Actions/GPTs)

• Claude Desktop

• Cursor IDE

• Cloudflare AI Playground

Related MCP server: SEFAZ BA: Emitir guia de IPVA

A Regra dos 70%

O etanol tem aproximadamente 70% do poder calorifico da gasolina. Isso significa que voce precisa de mais etanol para percorrer a mesma distancia.

• Etanol compensa se custar ate 70% do preco da gasolina

• GNV compensa se custar ate 60% do preco da gasolina

• Gasolina e melhor quando os alternativos custam mais que esses limites

Ferramentas Disponiveis

1. qual_combustivel_abastecer

Calcula qual combustivel e mais economico considerando o rendimento real.

Parametros:

Exemplo:

Gasolina: R$ 5.89, Etanol: R$ 3.99
Resultado: Etanol e 3.2% mais economico

2. calcular_economia

Calcula a economia em reais para um volume especifico.

Parametros:

3. comparar_viagem

Compara custos para uma viagem especifica.

Parametros:

Exemplo:

Viagem: 500 km, Consumo: 12 km/L
Gasolina: 41.7L = R$ 245.42
Etanol: 59.5L = R$ 237.50
Economia: R$ 7.92 (3.2%)

4. dicas_economia_combustivel

Retorna 7 dicas praticas para economizar combustivel.

Instalacao

# Clonar repositorio
git clone https://github.com/SEU_USUARIO/calculadora-combustivel.git
cd calculadora-combustivel

# Instalar dependencias
npm install

# Gerar tipos do Cloudflare
npm run cf-typegen

# Rodar localmente
npm run dev

Deploy

# Login na Cloudflare (primeira vez)
npx wrangler login

# Deploy
npm run deploy

Endpoints

Integracoes

ChatGPT (Actions/GPTs)

1. Crie um GPT personalizado

2. Adicione uma Action com a URL: https://seu-worker.workers.dev/sse

3. As 4 ferramentas serao importadas automaticamente

Claude Desktop

Adicione ao arquivo de configuracao:

{
  "mcpServers": {
    "calculadora-combustivel": {
      "command": "npx",
      "args": ["mcp-remote", "https://seu-worker.workers.dev/sse"]
    }
  }
}

Cloudflare AI Playground

1. Acesse: https://playground.ai.cloudflare.com/

2. Conecte usando a URL do seu worker

Tecnologias

• Cloudflare Workers - Serverless edge computing

• MCP Protocol - Model Context Protocol

• TypeScript - Type safety

• Zod - Schema validation

Scripts

npm run dev        # Desenvolvimento local
npm run deploy     # Deploy para Cloudflare
npm run type-check # Verificar tipos TypeScript
npm run cf-typegen # Gerar tipos do Cloudflare

Licenca

MIT