Amazon Server

A high-performance MCP (Model Context Protocol) server for searching Amazon India products with advanced features, fast caching, and many powerful tools.

🚀 Quick Start (Recommended)

Run instantly with npx (no installation required):

npx -y @magudeshwaran-hmw/amazon-mcp-server

🛠️ Configuration

Add this to your MCP settings (Cursor, Claude Desktop, etc.):

{
  "mcpServers": {
    "amazon-search": {
      "command": "npx",
      "args": ["-y", "@magudeshwaran-hmw/amazon-mcp-server"]
    }
  }
}

Note: Requires Python to be installed and available in your system PATH.

✨ Features

• 🔍 Fast Product Search - Search Amazon products with intelligent caching
• 📦 Product Details - Get price, rating, reviews, images, descriptions
• 🔥 Trending Products - Discover popular products based on access patterns
• 🏷️ Category-based Search - Filter by categories (electronics, etc.)
• 💸 Price Tracking - Track historical price changes
• ⭐ Favorites System - Save your favorite products
• 📜 Search History - Track your search history
• 🔄 Batch Operations - Search multiple products at once
• 📤 Export/Import - Export product data to JSON format
• 🎯 Recommendations - Get product recommendations (simulated)

📦 Local Development

If you want to run or modify the code locally:

1. Install Dependencies:

   pip install -r requirements.txt
   

2. Run Server:

   python main.py
   

3. Test Functionality:

   python test_server.py
   

🛠️ Available Tools

1. search_product

Search for Amazon products by name.

• query (string): Product name
• limit (int): Max results

2. get_product_details

Get detailed information.

• url (string): Product URL

3. get_trending_products

Get popular products.

4. get_price_history

• product_id (string): ASIN

5. add_to_favorites / remove_from_favorites

Manage your wishlist.

6. batch_search

Search multiple queries at once.

7. export_data

Export database to JSON.

⚡ Tech Stack

• Python: Core logic (mcp, aiosqlite, beautifulsoup4)
• Node.js: Distribution wrapper (npx)
• SQLite: Local caching