Metadata-Version: 2.4
Name: mmmegamarket-mcp
Version: 0.1.3
Summary: MCP server for MM retail and wholesale product data extraction
Project-URL: Homepage, https://github.com/CaullenOmdahl/MegaMarketPriceExtractorTool
Project-URL: Repository, https://github.com/CaullenOmdahl/MegaMarketPriceExtractorTool
Project-URL: Issues, https://github.com/CaullenOmdahl/MegaMarketPriceExtractorTool/issues
Author: MM Mega Market MCP Contributors
License: MIT
License-File: LICENSE
Keywords: b2b,b2c,mcp,mm-mega-market,model-context-protocol,price-comparison,retail,vietnam,wholesale
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: requests>=2.31.0
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# MM Query - MCP Server

Query products from MM's retail (B2C) and wholesale (B2B) platforms using the Model Context Protocol.

## Features

- 🔍 Search products across B2C and B2B platforms
- 💰 Compare retail vs wholesale prices
- 📦 Check stock availability
- 🏪 Multi-store support
- 🔗 Direct product links
- 🌐 Vietnamese language support

## Installation

### Via Smithery (Recommended)

```bash
smithery install mmmegamarket-mcp
```

### Via uvx

```bash
uvx mmmegamarket-mcp
```

### Via pip

```bash
pip install mmmegamarket-mcp
```

## Configuration

Add to your Claude Desktop config file:

**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
**Linux:** `~/.config/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "mm-query": {
      "command": "uvx",
      "args": ["mmmegamarket-mcp"],
      "env": {
        "MMPRO_USERNAME": "your_b2b_email@example.com",
        "MMPRO_PASSWORD": "your_b2b_password"
      }
    }
  }
}
```

**Note:** B2B credentials are optional. B2C (retail) features work without authentication.

## Available Tools

### 1. search_products
Search for products on MM.

**Note:** Product names and descriptions are in Vietnamese.

**Parameters:**
- `search_term` - Keyword in English or Vietnamese (e.g., 'rice'/'gạo', 'milk'/'sữa')
- `platform` - "b2c", "b2b", or "both" (default: "b2c")
- `page` - Page number (default: 1)
- `page_size` - Results per page, max 50 (default: 24)
- `sort_by` - Sort order: "relevance", "price_asc", "price_desc", etc.

### 2. compare_prices
Compare prices between B2C (retail) and B2B (wholesale) platforms.

**Parameters:**
- `search_term` - Product keyword
- `max_results` - Maximum products to compare (default: 20)

### 3. list_stores
List all MM store locations.

**Parameters:**
- `region` - "north", "central", "south", or "all" (default: "all")

### 4. set_store
Set the active store location for searches.

**Parameters:**
- `store_code` - Store code (e.g., '10010')

### 5. get_current_store
Get the currently active store location.

### 6. authenticate_b2b
Authenticate with B2B platform (optional).

**Parameters:**
- `username` - B2B account email
- `password` - B2B account password

### 7. get_auth_status
Check B2B authentication status.

### 8. get_product_details
Get detailed information about a specific product.

**Parameters:**
- `sku` - Product SKU
- `platform` - "b2c" or "b2b" (default: "b2c")

## Usage Examples

### Basic Product Search
```
Search for "coffee"
```

### Price Comparison
```
Compare prices for "cooking oil" between B2C and B2B
```

### Multi-Platform Search
```
Search for "rice" on both B2C and B2B platforms
```

### Store Selection
```
List stores in south region
Set store to 10010
Search for "milk"
```

## Language Note

The database is primarily in Vietnamese. Product names, descriptions, and categories will be in Vietnamese. Search terms can be provided in either English or Vietnamese.

## Platforms

### B2C Platform
- Consumer/retail platform
- Retail pricing
- No authentication required

### B2B Platform
- Business/wholesale platform
- Wholesale pricing (typically 5-15% cheaper)
- Optional authentication for full features

## PyPI Package

This MCP server is published as `mmmegamarket-mcp` on PyPI.

**Package URL:** https://pypi.org/project/mmmegamarket-mcp/

## License

MIT License

## Support

- **Issues:** https://github.com/CaullenOmdahl/mm-query/issues
- **PyPI:** https://pypi.org/project/mmmegamarket-mcp/
