Pumperly MCP

Consulta precios de combustible en tiempo real, encuentra estaciones cercanas, planifica rutas y geolocaliza ubicaciones en diferentes países.

GitHub

Documentación

Pumperly-MCP

Un puente diminuto que expone cualquier instancia de Pumperly como un servidor MCP, permitiendo a los LLMs consultar precios de combustible en tiempo real, encontrar estaciones, planificar rutas y geocodificar ubicaciones.

Lo que obtienes

Tipo	Para qué	MCP URI / Tool id
Recursos	Explorar configuración, estadísticas y tipos de cambio en modo solo lectura	`pumperly://config` `pumperly://stats` `pumperly://exchange-rates`
Herramientas	Encontrar estaciones, calcular rutas y geocodificar ubicaciones	`find_nearest_stations` `get_stations_in_area` `calculate_route` `find_route_stations` `geocode`

Todo se expone a través de un único endpoint JSON-RPC (/mcp). Los LLMs / Agentes pueden: initialize -> readResource -> listTools -> callTool ... y así sucesivamente.

Inicio 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 seguridad: El transporte HTTP escucha en 127.0.0.1:8080 por defecto. Si necesitas exponerlo en una red, colócalo detrás de un proxy inverso con autenticación.

Instalar vía npm (transporte stdio)

npx pumperly-mcp

O instalar globalmente:

npm install -g pumperly-mcp
pumperly-mcp

Esto descarga el binario Go precompilado desde GitHub Releases para tu plataforma y lo ejecuta con transporte stdio. Requiere al menos una versión publicada.

Compilación 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

Configuración

Variable	Default	Descripción
`PUMPERLY_URL`	`https://pumperly.com`	URL de la instancia de Pumperly (sin / final)
`LISTEN_ADDR`	`127.0.0.1:8080`	Dirección de escucha HTTP (Docker establece `0.0.0.0:8080`)
`TRANSPORT`	(vacío = HTTP)	Establecer a `stdio` para transporte stdio

Ponlas en un archivo .env (desde .env.example) o configúralas en el entorno.

Pruebas

Probado con Inspector y actualmente funciona completamente. Antes de hacer un PR, asegúrate de que este servidor MCP se comporte bien a través de este medio.

Ejemplo de configuración 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 -- agregación de precios de combustible en tiempo real

MCP-GO -- implementación moderna de MCP

GoReleaser -- lanzamientos multi-arquitectura sin dolor

Mantenedores

@GeiserX.

Contribuciones

¡Siéntete libre de participar! Abre un issue o envía PRs.

Pumperly-MCP sigue el Contributor Covenant Código de Conducta.

Otros Servidores MCP de GeiserX

cashpilot-mcp — Monitoreo de ingresos pasivos
duplicacy-mcp — Monitoreo de salud de respaldos
genieacs-mcp — Gestión de dispositivos TR-069
lynxprompt-mcp — Planos de configuración de IA
telegram-archive-mcp — Archivo de mensajes de Telegram

Proyectos Relacionados

Proyecto	Descripción
Pumperly	Planificador de rutas de combustible y EV de código abierto con precios en tiempo real
Pumperly-android	Aplicación oficial de Android para el planificador de rutas de combustible y EV de Pumperly
pumperly-ha	Integración personalizada de Home Assistant para precios de combustible y carga EV de Pumperly
n8n-nodes-pumperly	Nodo comunitario de n8n para datos de combustible y carga EV de Pumperly