GasBuddy MCP Price Tracker

The GasBuddy MCP Price Tracker is a Model Context Protocol (MCP) server that scrapes real-time gas prices on gasbuddy.com using Playwright. It finds the cheapest fuel in any US city or zip code.

Requirements

• Python 3.10+

• Playwright

• Playwright-Stealth

• FastMCP

Installation & Setup

1. Clone the repository and navigate to the project directory.

2. Create and activate a virtual environment.

   macOS/Linux

   python3 -m venv venv
   source venv/bin/activate

   Windows

   python -m venv venv
   .\venv\Scripts\activate

3. Install dependencies: pip install -r requirements.txt

4. Install browser binaries: playwright install chromium

5. Test the standalone tool (CLI): python gas_tool.py

Setup in Claude Desktop

To allow Claude Desktop to interact with the MCP server to get the cheapest gas prices, you will need to update your claude_desktop_config.json file and replace {absolute_path_to} with the absolute path to the cloned repository folder.

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

Example in Claude

License

This application is distributed under the MIT License.