gdebenz-mcp

ロシアのガソリンスタンドでガソリン・軽油を検索するためのMCPサーバー。2つの独立した情報源 — gdebenz.ru と gdebenzi.ru — を統合します。これらは、ドライバーによるリアルタイムの書き込みがある燃料在庫のコミュニティマップです。

あなたのAIアシスタント（Claude、Cursor、OpenClawなど）が、次のような質問に答えられるようにします：

「ヒムキの近くで95ガソリンがあるのはどこ？」 「軽油がある最寄りのルクオイルのスタンドはどこ？ そこに行列はある？」

両サービスの公開APIを通じて動作します。APIキー不要 — 必要なのはPythonと2つのパッケージだけです。

2つのデータソース

検索ツールには source パラメータがあります："gdebenz"、"gdebenzi"、または "both"（デフォルトは both — 最大のカバレッジ）。

インストール

1. リポジトリをクローン

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

2. 依存関係をインストール

pip install -r requirements.txt

Python 3.10+ が必要です。

3. サーバーをアシスタントに接続

Claude Desktop — claude_desktop_config.json を開く/作成：

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

Cursor — プロジェクトの .cursor/mcp.json（またはグローバルの ~/.cursor/mcp.json）：

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

OpenClaw：

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

⚠️ /絶対/パス/ を、リポジトリをクローンした実際のパスに置き換えてください（フォルダ内で pwd コマンドで確認できます）。

Related MCP server: gasolineras-mcp

AIエージェント向け手順

ユーザーが「このMCPサーバーをセットアップして」と頼んだ場合、次の手順を実行します：

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

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

3. ユーザーのMCPホスト（Claude Desktop / Cursor / OpenClaw）を特定し、上記のように gdebenz エントリをその設定ファイルに追加します（server.py への絶対パスを使用）。

4. ホスト/アプリケーションを再起動します。

5. サーバーが表示されることを確認します（OpenClawの場合：openclaw mcp probe gdebenz）。

stdioサーバーで、外部キーは不要です。

機能（9つのツール）

アシスタントへのリクエスト例： find_fuel(location="Химки", fuel="95", brand="Лукойл", source="both")。

セマンティクス

• 燃料：92, 95, 98, 100, 軽油。gdebenz では fuels_now（カンマ区切りの文字列）、gdebenzi では fuels_yes / fuels_no / fuels_maybe（ロシア語名の配列、例：["АИ-95", "ДТ"]）。

• ステータス：yes — あり、queue — あり/行列、low — 少ない、no — なし、unknown — 不明、changing — 更新中、dtonly — 軽油のみ。

• 鮮度：gdebenz では last_at、confirmations、confidence（0..1）；gdebenzi では last_mark（書き込み時刻）、confidence_pct、marks、reports。両ソースとも age_minutes と freshness（「たった今」、「3時間前」）を返します。

• 行列/制限（gdebenzi）：queue（「行列 25〜50台」）、limits（グレードごとのリットル制限）。

• 価格：gdebenz では prices_now[fuel].t（価格レポートの時刻）；gdebenzi では prices（キー：ai92/ai95/ai98/ai100/dt/gas）と regional_prices（地域平均）。

API（データの取得元）

gdebenz.ru

gdebenzi.ru

ライセンス

MIT