Pumperly MCP

Consulte preços de combustível em tempo real, encontre postos próximos, planeje rotas e geocode localizações em diferentes países.

GitHub

Documentação

Pumperly-MCP

Uma pequena ponte que expõe qualquer instância Pumperly como um servidor MCP, permitindo que LLMs consultem preços de combustível em tempo real, encontrem postos, planejem rotas e façam geocodificação de locais.

O que você obtém

Tipo	Para quê	URI MCP / id da ferramenta
Recursos	Navegue pela configuração, estatísticas e taxas de câmbio somente leitura	`pumperly://config` `pumperly://stats` `pumperly://exchange-rates`
Ferramentas	Encontre postos, calcule rotas e faça geocodificação de locais	`find_nearest_stations` `get_stations_in_area` `calculate_route` `find_route_stations` `geocode`

Tudo é exposto por meio de um único endpoint JSON-RPC (/mcp). LLMs / Agentes podem: initialize -> readResource -> listTools -> callTool ... e assim por diante.

Início rápido (Docker Compose)

services:
  pumperly-mcp:
    image: drumsergio/pumperly-mcp:latest
    ports:
      - "127.0.0.1:8080:8080"
    environment:
      - PUMPERLY_URL=https://pumperly.com

Nota de segurança: O transporte HTTP escuta em 127.0.0.1:8080 por padrão. Se você precisar expô-lo em uma rede, coloque-o atrás de um proxy reverso com autenticação.

Instalação via npm (transporte stdio)

npx pumperly-mcp

Ou instale globalmente:

npm install -g pumperly-mcp
pumperly-mcp

Isso baixa o binário Go pré-compilado do GitHub Releases para sua plataforma e o executa com transporte stdio. Requer pelo menos um release publicado.

Build local

git clone https://github.com/GeiserX/pumperly-mcp
cd pumperly-mcp

# (optional) create .env from the sample
cp .env.example .env && $EDITOR .env

go run ./cmd/server

Configuração

Variável	Padrão	Descrição
`PUMPERLY_URL`	`https://pumperly.com`	URL da instância Pumperly (sem / no final)
`LISTEN_ADDR`	`127.0.0.1:8080`	Endereço de escuta HTTP (o Docker define `0.0.0.0:8080`)
`TRANSPORT`	(vazio = HTTP)	Defina como `stdio` para transporte stdio

Coloque-os em um arquivo .env (de .env.example) ou defina-os no ambiente.

Testes

Testado com Inspector e está totalmente funcional atualmente. Antes de fazer um PR, certifique-se de que este servidor MCP se comporta bem por esse meio.

Exemplo de configuração para LLMs clientes

{
  "schema_version": "v1",
  "name_for_human": "Pumperly-MCP",
  "name_for_model": "pumperly_mcp",
  "description_for_human": "Query real-time fuel prices, find stations, plan routes, and geocode locations via Pumperly.",
  "description_for_model": "Interact with a Pumperly instance that aggregates fuel station data. First call initialize, then reuse the returned session id in header \"Mcp-Session-Id\" for every other call. Use readResource to fetch URIs that begin with pumperly://. Use listTools to discover available actions and callTool to execute them.",
  "auth": { "type": "none" },
  "api": {
    "type": "jsonrpc-mcp",
    "url":  "http://localhost:8080/mcp",
    "init_method": "initialize",
    "session_header": "Mcp-Session-Id"
  },
  "logo_url": "https://pumperly.com/logo.png",
  "contact_email": "acsdesk@protonmail.com",
  "legal_info_url": "https://github.com/GeiserX/pumperly-mcp/blob/main/LICENSE"
}

Créditos

Pumperly -- agregação de preços de combustível em tempo real

MCP-GO -- implementação MCP moderna

GoReleaser -- releases multi-arquitetura sem dor

Mantenedores

@GeiserX.

Contribuindo

Sinta-se à vontade para mergulhar! Abra uma issue ou envie PRs.

Pumperly-MCP segue o Contributor Covenant Código de Conduta.

Outros servidores MCP por GeiserX

cashpilot-mcp — Monitoramento de renda passiva
duplicacy-mcp — Monitoramento de saúde de backups
genieacs-mcp — Gerenciamento de dispositivos TR-069
lynxprompt-mcp — Modelos de configuração de IA
telegram-archive-mcp — Arquivo de mensagens do Telegram

Projetos relacionados

Projeto	Descrição
Pumperly	Planejador de rotas de combustível e veículos elétricos de código aberto com preços em tempo real
Pumperly-android	Aplicativo Android oficial para o planejador de rotas de combustível e veículos elétricos Pumperly
pumperly-ha	Integração personalizada do Home Assistant para preços de combustível e carregamento de veículos elétricos Pumperly
n8n-nodes-pumperly	Nó da comunidade n8n para dados de combustível e carregamento de veículos elétricos Pumperly