# Amazon MCP Server

This is a Model Context Protocol (MCP) server for scraping Amazon products and searching for products on Amazon.

## Setup

1. **Clone the repository:**
   ```bash
   git clone https://github.com/r123singh/amazon-mcp-server.git
   ```
2. **Navigate to the project directory:**
   ```bash
   cd amazon-mcp-server
   ```
3. **Create a virtual environment:**
   ```bash
   python -m venv venv
   ```
4. **Activate the virtual environment:**
   - On Linux/macOS:
     ```bash
     source venv/bin/activate
     ```
   - On Windows:
     ```bash
     venv\Scripts\activate
     ```
5. **Install dependencies:**
   ```bash
   pip install -r requirements.txt
   ```

6. **No API keys or tokens are required.**

7. **Configure MCP JSON:**
   Create a `mcp.json` file with:
   ```json
   {
     "mcpServers": {
       "amazon": {
         "command": "{PATH_TO_DIRECTORY}\\amazon-mcp-server\\venv\\Scripts\\python.exe",
         "args": [
           "{PATH_TO_DIRECTORY}\\amazon-mcp-server\\server.py"
         ]
       }
     }
   }
   ```
   Replace `{PATH_TO_DIRECTORY}` with the absolute path to this directory (use `pwd` or `cd` to get the path).

## Available Tools

The server provides the following tools for interacting with Amazon:

- **Scrape a product:**  
  `scrape_product(product_url)`  
  Scrape product details (name, price, image, rating, reviews, availability, description) from a given Amazon product URL.

- **Search for products:**  
  `search_products(query, max_results)`  
  Search for products on Amazon by keyword and return a list of results.

## Usage

Once configured, the MCP server can be started using the standard MCP client configuration. The server provides a natural language interface to interact with Amazon through the available tools.

**Example usage:**
- "Get details for this Amazon product: [product URL]"
- "Search Amazon for 'wireless headphones', show top 3 results"

## Notes

- No API key or authentication is required.
- The server scrapes publicly available Amazon product and search pages.
- For best results, use valid Amazon product URLs and clear search queries.

## Contributing

Contributions are welcome! Please open an issue or submit a pull request.

## License

This project is licensed under the MIT License. See the LICENSE file for details.