mcp-shop

MCP Shop Server is an MCP server that helps you browse and compare deals across multiple online retailers. It uses Playwright to navigate and extract information from compatible websites (such as various Amazon sites, eBay, and several deal aggregation sites) to help your AI model find the best offers. The server is designed to be run via an MCP client (e.g., through the MCP protocol) so your agent can issue queries and receive structured results on product availability, prices, and deals from supported shops. To use it, run the server via your MCP client configuration and then query it for product searches, price comparisons, or deal gathering. The server leverages Playwright to interact with live sites, so results reflect current listings and prices where possible.

Prerequisites:

• Node.js (v14+ recommended) and npm installed on your machine
• Internet access to download dependencies from npm

Installation steps:

1. Clone the repository (or obtain the MCP server source): git clone https://github.com/johan-perso/mcp-shop-server cd mcp-shop-server

2. Install dependencies: npm install

3. Run the MCP server via the standard MCP configuration (as shown in the README):

   • If you are using an MCP client, you can register the server with the provided example: npx mcp-client-register 'mcp-shop-server' --config '{"mcpServers": {"mcp-shop-server": {"command": "npx", "args": ["mcp-shop-server@latest"]}}}'
   • Alternatively, directly start the server for local testing using the example: npx mcp-shop-server@latest

4. Verify the server responds to MCP requests using your MCP client and the example configuration from the README.

Notes:

• The server relies on Playwright to browse live retailer sites, which may require browser binaries to be downloaded by Playwright during first run.
• Ensure you have network access to the target retailer sites from your running environment.

Tips and considerations:

• Compatible sites include Amazon (multiple regional domains), eBay, Dealabs and other deal aggregators. Availability may vary by region and site layout changes can affect scraping.
• Playwright-based browsing means occasional failures if a site blocks automation or changes its layout; keep Playwright up to date.
• If running behind proxies or in restricted environments, ensure Node.js can reach external websites and that any necessary permissions for Playwright browsers are granted.
• The MCP config example uses the package name mcp-shop-server@latest; you can pin a specific version if needed.
• If you encounter issues, check for updated dependencies or consult the repository issues for compatibility notes.