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)를 확인하고 위에 표시된 대로 해당 구성에 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