Skip to main content
Glama
calculadora-combustivel

calculadora-combustivel

by comeca-ai

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: Tabela FIPE

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:

Parametro

Tipo

Obrigatorio

Descricao

preco_gasolina

number

Sim

Preco do litro (R$ 2.50 - 10.00)

preco_etanol

number

Sim

Preco do litro (R$ 2.50 - 10.00)

preco_gnv

number

Nao

Preco do m3 (R$ 2.50 - 10.00)

modo_saida

string

Nao

"completo" ou "resumido"

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:

Parametro

Tipo

Obrigatorio

Descricao

preco_gasolina

number

Sim

Preco do litro

preco_etanol

number

Sim

Preco do litro

litros

number

Sim

Quantidade (1 - 1000)

preco_gnv

number

Nao

Preco do m3

3. comparar_viagem

Compara custos para uma viagem especifica.

Parametros:

Parametro

Tipo

Obrigatorio

Descricao

distancia

number

Sim

Distancia em km (1 - 10000)

consumo_gasolina

number

Sim

Consumo do veiculo em km/L (3 - 30)

preco_gasolina

number

Sim

Preco do litro

preco_etanol

number

Sim

Preco do litro

preco_gnv

number

Nao

Preco do m3

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

Endpoint

Descricao

/sse

MCP via Server-Sent Events

/mcp

MCP via HTTP

/health

Health check com versao e tools

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

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides vehicle reference prices in Brazil (Tabela FIPE) for cars, motorcycles, and trucks, enabling navigation by brand/model/year, historical price queries, depreciation curves, and fuzzy model search.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to query real-time, audited Brazilian public data on fuel and LPG prices, regulated medicine ceilings and Farmácia Popular eligibility, and basic food basket/cost-of-living indicators across all 27 states via MCP tools, prompts, and resources.
      11
      MIT