GasBuddy MCP Price Tracker

Servidor MCP para obter os preços de gasolina mais baratos em uma cidade ou código postal específico do gasbuddy.com

Documentação

GasBuddy MCP Price Tracker

SafeSkill 93/100

O GasBuddy MCP Price Tracker é um servidor Model Context Protocol (MCP) que coleta preços de gasolina em tempo real no gasbuddy.com usando Playwright. Ele encontra o combustível mais barato em qualquer cidade ou CEP dos EUA.

[!NOTE] Este projeto é apenas para fins educacionais. A GasBuddy reserva-se o direito de modificar a estrutura do seu site a qualquer momento, o que pode quebrar este script. O autor não oferece garantia de funcionalidade e não se responsabiliza por problemas decorrentes do seu uso. Contribuições e correções da comunidade são altamente incentivadas.

Requisitos

  • Python 3.10+
  • Playwright
  • Playwright-Stealth
  • FastMCP

Instalação e Configuração

  1. Clone o repositório e navegue até o diretório do projeto.

  2. Crie e ative um ambiente virtual.

    macOS/Linux

    python3 -m venv venv
    source venv/bin/activate
    

    Windows

    python -m venv venv
    .\venv\Scripts\activate
    
  3. Instale as dependências: pip install -r requirements.txt

  4. Instale os binários do navegador: playwright install chromium

  5. Teste a ferramenta autônoma (CLI): python gas_tool.py

Configuração no Claude Desktop

Para permitir que o Claude Desktop interaja com o servidor MCP e obtenha os preços de gasolina mais baratos, você precisará atualizar o arquivo claude_desktop_config.json e substituir {absolute_path_to} pelo caminho absoluto da pasta do repositório clonado.

{
  "mcpServers": {
    "gas-buddy": {
      "command": "/{absolute_path_to}/venv/bin/python",
      "args": ["/{absolute_path_to}/gas_server.py"]
    }
  }
}

Exemplo no Claude

Example from Claude

Licença

Este aplicativo é distribuído sob a Licença MIT.