gdebenz-mcp

用于搜索俄罗斯加油站汽油和柴油的MCP服务器。整合了两个独立信源——gdebenz.ru 和 gdebenzi.ru——即由驾驶员实时标记的民间燃料供应地图。

它可以让您的AI助手（Claude、Cursor、OpenClaw等）回答诸如以下问题：

「希姆基附近哪里能加到95号汽油？」 「最近的卢克石油加油站在哪，有柴油吗，排队吗？」

通过两个服务的公开API运行。无需API密钥——只需要Python和两个包。

两个数据源

搜索工具带有 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: opinet-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），按照上述方式（使用指向 server.py 的绝对路径）将 gdebenz 条目添加到其配置中。

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