MCP.so

๐Ÿ›๏ธ MCP - MCP for Commerce Platforms - Universal E-commerce Customer Support Assistant

@slavpilus

๐Ÿ›๏ธ MCP - MCP for Commerce Platforms - Universal E-commerce Customer Support Assistant ใซใคใ„ใฆ

MCP for Commerce Platforms

ๅŸบๆœฌๆƒ…ๅ ฑ

ใ‚ซใƒ†ใ‚ดใƒช

AI ใจใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ

ใƒฉใ‚คใ‚ปใƒณใ‚น

MIT license

ใƒฉใƒณใ‚ฟใ‚คใƒ 

python

ใƒˆใƒฉใƒณใ‚นใƒใƒผใƒˆ

stdio

ๅ…ฌ้–‹่€…

slavpilus

่จญๅฎš

ไปฅไธ‹ใฎ่จญๅฎšใ‚’ไฝฟใฃใฆใ€ใ“ใฎใ‚ตใƒผใƒใƒผใ‚’ MCP ๅฏพๅฟœใ‚ฏใƒฉใ‚คใ‚ขใƒณใƒˆใซ่ฟฝๅŠ ใ—ใฆใใ ใ•ใ„ใ€‚

{
  "mcpServers": {
    "mcp-slavpilus": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

ใƒ„ใƒผใƒซ

ใƒ„ใƒผใƒซใฏๆคœๅ‡บใ•ใ‚Œใพใ›ใ‚“ใงใ—ใŸ

ใƒ„ใƒผใƒซใฏ README ใ‹ใ‚‰่‡ชๅ‹•็š„ใซๆŠฝๅ‡บใ•ใ‚Œใพใ™ใ€‚ใƒกใƒณใƒ†ใƒŠใƒผใฏ ## Tools ใจใ„ใ†่ฆ‹ๅ‡บใ—ใฎไธ‹ใซ่จ˜่ผ‰ใ™ใ‚‹ใ“ใจใงใ€ใ“ใฎใ‚ฟใƒ–ใซๅๆ˜ ใงใใพใ™ใ€‚

ๆฆ‚่ฆ

What is ๐Ÿ›๏ธ MCP - MCP for Commerce Platforms - Universal E-commerce Customer Support Assistant?

It is a platform-agnostic customer support assistant that connects to any e-commerce platform through pluggable strategies, using the MCP (Model Context Protocol) server and Gradio for the user interface. It is built for developers and support teams who need a single conversational interface to manage orders, returns, and cancellations across multiple eโ€‘commerce backends.

How to use ๐Ÿ›๏ธ MCP - MCP for Commerce Platforms - Universal E-commerce Customer Support Assistant?

Clone the repository, run the setup script (scripts/setup_dev.sh) or manually create a virtual environment, install dependencies from requirements-dev.txt, copy .env.example to .env and configure it, then run python app.py. The application will be available at http://localhost:7860.

Key features of ๐Ÿ›๏ธ MCP - MCP for Commerce Platforms - Universal E-commerce Customer Support Assistant

  • Order management: track orders, check status, view history
  • Returns and refunds: initiate returns, process refunds
  • Order cancellations: quick and easy cancellations
  • Conversational interface using natural language
  • Platform-agnostic, extensible via a strategy pattern
  • Autoโ€‘deployment to Hugging Face Spaces

Use cases of ๐Ÿ›๏ธ MCP - MCP for Commerce Platforms - Universal E-commerce Customer Support Assistant

  • A single customerโ€‘facing chat that handles orders from Shopify, Magento, WooCommerce, and other platforms
  • Integrating a conversational support assistant into an existing multiโ€‘platform eโ€‘commerce operation
  • Rapidly prototyping customer support for a new eโ€‘commerce store using mock data
  • Deploying a selfโ€‘hosted support assistant to Hugging Face Spaces for internal testing

FAQ from ๐Ÿ›๏ธ MCP - MCP for Commerce Platforms - Universal E-commerce Customer Support Assistant

Which eโ€‘commerce platforms are supported out of the box?

The README lists MockData, Shopify, Magento, and WooCommerce as platform strategies, and the architecture is extensible to any platform via the strategy interface.

What are the runtime requirements?

Python 3.10 or higher, Git, and a virtual environment tool (venv) are required. All dependencies are listed in requirements-dev.txt.

How do I run the application locally after installation?

Execute python app.py from the project root. The Gradio interface will be available at http://localhost:7860.

How can I deploy the assistant to production?

The project is configured for automatic deployment to Hugging Face Spaces via GitHub Actions on pushes to the main branch, or manual deployment by adding the Spaces remote and pushing.

How do I add support for a new eโ€‘commerce platform?

Create a new strategy class in mcp_server/strategies/ that inherits from EcommerceStrategy, implement the required methods, add tests, and update the strategy factory.

ใ‚ณใƒกใƒณใƒˆ

ใ€ŒAI ใจใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใ€ใฎไป–ใฎใ‚ณใƒณใƒ†ใƒณใƒ„