gdebenz-mcp

MCP-Server zur Suche von Benzin und Diesel an Tankstellen in Russland. Kombiniert zwei unabhängige Quellen – gdebenz.ru und gdebenzi.ru – Volkskarten zur Kraftstoffverfügbarkeit mit Echtzeit-Meldungen von Fahrern.

Ermöglicht Ihrem KI-Assistenten (Claude, Cursor, OpenClaw usw.), Fragen zu beantworten wie:

„Wo in der Nähe von Chimki gibt es Benzin 95?“ „Welche ist die nächste Lukoil-Tankstelle mit Diesel, und gibt es dort eine Schlange?“

Funktioniert über die öffentlichen APIs beider Dienste. Ohne API-Schlüssel – benötigt werden nur Python und zwei Pakete.

Zwei Datenquellen

Die Suchwerkzeuge haben den Parameter source: "gdebenz", "gdebenzi" oder "both" (Standard: both – maximale Abdeckung).

Installation

1. Repository klonen

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

2. Abhängigkeiten installieren

pip install -r requirements.txt

Erforderlich: Python 3.10+.

3. Server mit Ihrem Assistenten verbinden

Claude Desktop – öffnen/erstellen Sie claude_desktop_config.json:

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

Cursor – in .cursor/mcp.json des Projekts (oder 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

⚠️ Ersetzen Sie /ABSOLUTER/PFAD/ durch den tatsächlichen Pfad, in den das Repository geklont wurde (ermittelbar mit dem Befehl pwd im Ordner).

Related MCP server: opinet-mcp

Anleitung für den KI-Agenten

Wenn der Benutzer „installiere diesen MCP-Server“ sagt, gehen Sie wie folgt vor:

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

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

3. Ermitteln Sie den MCP-Host des Benutzers (Claude Desktop / Cursor / OpenClaw) und fügen Sie den Eintrag gdebenz in dessen Konfiguration ein, wie oben gezeigt (mit absolutem Pfad zu server.py).

4. Starten Sie den Host/die Anwendung neu.

5. Prüfen Sie, ob der Server sichtbar ist (in OpenClaw: openclaw mcp probe gdebenz).

Server stdio, keine externen Schlüssel erforderlich.

Was es kann (9 Werkzeuge)

Beispielanfrage an den Assistenten: find_fuel(location="Chimki", fuel="95", brand="Lukoil", source="both").

Semantik

• Kraftstoff: 92, 95, 98, 100, Diesel. Bei gdebenz – fuels_now (Zeichenfolge mit Kommas), bei gdebenzi – fuels_yes / fuels_no / fuels_maybe (Arrays mit russischen Bezeichnungen, z. B. ["АИ-95", "ДТ"]).

• Status: yes – vorhanden, queue – vorhanden/Schlange, low – wenig, no – nicht vorhanden, unknown – unbekannt, changing – wird aktualisiert, dtonly – nur Diesel.

• Aktualität: bei gdebenz – last_at, confirmations, confidence (0..1); bei gdebenzi – last_mark (Zeitpunkt der Meldung), confidence_pct, marks, reports. Beide Quellen liefern age_minutes und freshness („gerade eben“, „vor 3 Std.“).

• Schlange/Limits (gdebenzi): queue („Schlange 25–50 Autos“), limits (Limit in Litern pro Kraftstoffsorte).

• Preise: gdebenz – prices_now[fuel].t (Zeitpunkt der Preisangabe); gdebenzi – prices (Schlüssel ai92/ai95/ai98/ai100/dt/gas) und regional_prices (regionale Durchschnittspreise).

API (Datenquellen)

gdebenz.ru

gdebenzi.ru

Lizenz

MIT