Bargainer MCP Client 🛍️
A powerful Model Context Protocol (MCP) client for finding and comparing deals from multiple sources including Slickdeals, RapidAPI marketplace, and web scraping. Features a modern web-based chat interface for interactive deal searching.
Features ✨
- Multi-Source Deal Aggregation: Integrates with Slickdeals API, RapidAPI marketplace, and web scraping
- Interactive Chat Interface: Modern web UI with real-time messaging via Socket.IO
- Intelligent Deal Filtering: Filter by price, rating, store, and category
- Deal Comparison: Compare deals across multiple sources
- MCP Protocol Integration: Full Model Context Protocol implementation with 6 specialized tools
- Provider Pattern Architecture: Extensible design for adding new deal sources
- TypeScript: Fully typed codebase with strict type checking
Quick Start 🚀
Prerequisites
- Node.js 18+
- npm or yarn
- API keys for external services (optional, fallback to mock data)
Installation
# Clone the repository
git clone https://github.com/karthiksivaramms/bargainer-mcp-client.git
cd bargainer-mcp-client
# Install dependencies
npm install
# Build the project
npm run build
Usage
Web Chat Interface
# Start the web interface
npm run web
# Or with auto-reload for development
npm run dev:web
Then open http://localhost:3001 in your browser and start chatting!
MCP Server
# Start the MCP server
npm run dev
# Or run the built version
npm start
Demo & Testing
# Run interactive demo
npm run demo
# Test the server
npm run test:server
Available Commands 💬
Use these natural language commands in the chat interface:
- Search deals: "Find laptop deals under $500"
- Get top deals: "Show me today's top electronics deals"
- Filter deals: "Gaming headphones under $100 with 4+ stars"
- Deal details: "Tell me more about this iPhone deal"
- Compare deals: "Compare iPad deals across sources"
- List sources: "What deal sources are available?"
MCP Tools 🛠️
The server provides 6 specialized tools:
- search_deals - Search for deals by product name or keywords
- get_top_deals - Get trending deals from all sources
- filter_deals - Filter deals by price, rating, store, category
- get_deal_details - Get detailed information about specific deals
- compare_deals - Compare deals across multiple sources
- get_available_sources - List all configured deal sources
Architecture 🏗️
src/
├── server.ts # Main MCP server
├── providers/ # Deal source providers
│ ├── base.ts # Base provider interface
│ ├── slickdeals.ts # Slickdeals API provider
│ ├── rapidapi.ts # RapidAPI marketplace provider
│ └── webscraping.ts # Web scraping provider
├── services/
│ └── aggregator.ts # Deal aggregation service
└── types/ # TypeScript type definitions
ui/
├── index.html # Chat interface
├── chat-interface.js # Frontend JavaScript
└── server.js # Express server with Socket.IO
test/ # Test files
scripts/ # Utility scripts
Contributing 🤝
Contributions are welcome! Please feel free to submit a Pull Request.
Development Setup
# Install dependencies
npm install
# Start development with auto-reload
npm run dev
# Start web interface with auto-reload
npm run dev:web
# Run linting
npm run lint
# Format code
npm run format
Adding New Deal Sources
- Create a new provider in
src/providers/ - Extend
BaseDealProvider - Implement required methods
- Register in
aggregator.ts
API Documentation 📚
Deal Object Structure
interface Deal {
id: string;
title: string;
price: number;
originalPrice?: number;
discount?: number;
rating?: number;
store: string;
url: string;
imageUrl?: string;
description?: string;
category?: string;
source: string;
timestamp: Date;
}
License 📄
This project is licensed under the MIT License - see the LICENSE file for details.
Author 👨💻
Karthik Sivaram M
- GitHub: @karthiksivaramms
Support 💡
If you have any questions or run into issues, please open an issue on GitHub.
Roadmap 🗺️
- More deal source integrations
- Deal alerts and notifications
- Price history tracking
- Advanced filtering options
- Mobile app version
- Deal sharing features
Made with ❤️ for bargain hunters everywhere!