gdebenz-mcp

Servidor MCP para buscar gasolina y diésel en gasolineras de Rusia. Combina dos fuentes independientes — gdebenz.ru y gdebenzi.ru — mapas colaborativos de disponibilidad de combustible con reportes de conductores en tiempo real.

Permite que tu asistente de IA (Claude, Cursor, OpenClaw, etc.) responda preguntas como:

«¿Dónde hay gasolina 95 cerca de Jímki?» «¿Cuál es la gasolinera Lukoil más cercana con diésel y hay cola?»

Funciona a través de las API públicas de ambos servicios. Sin claves API — solo necesitas Python y dos paquetes.

Dos fuentes de datos

Las herramientas de búsqueda tienen el parámetro source: "gdebenz", "gdebenzi" o "both" (por defecto both — máxima cobertura).

Instalación

1. Clona el repositorio

git clone https://github.com/ivanegorenkov/gdebenz-mcp.git
cd gdebenz-mcp

2. Instala las dependencias

pip install -r requirements.txt

Se necesita Python 3.10+.

3. Conecta el servidor a tu asistente

Claude Desktop — abre/crea claude_desktop_config.json:

{
  "mcpServers": {
    "gdebenz": {
      "command": "python3",
      "args": ["/АБСОЛЮТНЫЙ/ПУТЬ/gdebenz-mcp/server.py"]
    }
  }
}

Cursor — en .cursor/mcp.json del proyecto (o global ~/.cursor/mcp.json):

{
  "mcpServers": {
    "gdebenz": {
      "command": "python3",
      "args": ["/АБСОЛЮТНЫЙ/ПУТЬ/gdebenz-mcp/server.py"]
    }
  }
}

OpenClaw:

openclaw mcp add gdebenz --command python3 --arg /АБСОЛЮТНЫЙ/ПУТЬ/gdebenz-mcp/server.py

⚠️ Reemplaza /RUTA/ABSOLUTA/ por la ruta real donde se clonó el repositorio (puedes averiguarla con el comando pwd dentro de la carpeta).

Related MCP server: opinet-mcp

Instrucciones para el agente de IA

Si el usuario pide «instala este servidor MCP», haz lo siguiente:

1. git clone https://github.com/ivanegorenkov/gdebenz-mcp.git

2. cd gdebenz-mcp && pip install -r requirements.txt

3. Determina el host MCP del usuario (Claude Desktop / Cursor / OpenClaw) y añade la entrada gdebenz a su configuración, como se muestra arriba (con la ruta absoluta a server.py).

4. Reinicia el host/aplicación.

5. Verifica que el servidor sea visible (en OpenClaw: openclaw mcp probe gdebenz).

Servidor stdio, no requiere claves externas.

Qué puede hacer (9 herramientas)

Ejemplo de consulta al asistente: find_fuel(location="Химки", fuel="95", brand="Лукойл", source="both").

Semántica

• Combustible: 92, 95, 98, 100, ДТ. En gdebenz — fuels_now (cadena separada por comas), en gdebenzi — fuels_yes / fuels_no / fuels_maybe (arrays con nombres en ruso, p. ej. ["АИ-95", "ДТ"]).

• Estado: yes — hay, queue — hay/cola, low — poco, no — no hay, unknown — desconocido, changing — actualizándose, dtonly — solo diésel.

• Actualidad: en gdebenz — last_at, confirmations, confidence (0..1); en gdebenzi — last_mark (hora del reporte), confidence_pct, marks, reports. Ambas fuentes devuelven age_minutes y freshness («hace un momento», «hace 3 h»).

• Cola/límites (gdebenzi): queue («cola de 25–50 autos»), limits (límite en litros por tipo).

• Precios: gdebenz — prices_now[fuel].t (hora del informe de precio); gdebenzi — prices (claves ai92/ai95/ai98/ai100/dt/gas) y regional_prices (promedios por región).

API (de dónde vienen los datos)

gdebenz.ru

gdebenzi.ru

Licencia

MIT