pumperly-mcp

Qué obtienes

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

Related MCP server: Foundry MCP Server

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.

Instalación vía npm (transporte stdio)

npx pumperly-mcp

O instálalo globalmente:

npm install -g pumperly-mcp
pumperly-mcp

Esto descarga el binario de 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

Colócalas en un archivo .env (desde .env.example) o establécelas en el entorno.

Pruebas

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

Ejemplo de configuración para clientes LLM

{
  "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 complicaciones

Mantenedores

@GeiserX.

Contribución

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

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

Otros servidores MCP de GeiserX

• cashpilot-mcp — Monitoreo de ingresos pasivos

• duplicacy-mcp — Monitoreo de salud de copias de seguridad

• 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