1. Conduid
  2. Other
  3. UI Demo EcomV1
MCP server · Other

UI Demo EcomV1

by · github.com/Basavaraj-Km-GT/MCP-UI-Demo-EcomV1
Unclaimed last commit 8 months ago other
InstallView source
30Low

Scored 7 months ago · breakdown

About UI Demo EcomV1

UI Demo EcomV1 is an MCP server published by Basavaraj-Km-GT in the Other category.

Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/Basavaraj-Km-GT/MCP-UI-Demo-EcomV1

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (7)

add_to_cartAdd product to cart

Parameters not published.

filter_productsFilter by category

Parameters not published.

get_cartGet cart contents

Parameters not published.

get_categoriesGet all categories

Parameters not published.

get_productsGet all products

Parameters not published.

remove_from_cartRemove product from cart

Parameters not published.

search_productsSearch products by name/keyword

Parameters not published.

Ask AI

✦

Ask AI about UI Demo EcomV1

Powered by Claude · Grounded in docs

I know everything about UI Demo EcomV1. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

MCP E-Commerce Application

A full-stack e-commerce application built with MCP-UI, React, TypeScript, and integrated with OpenAI for AI-powered shopping assistance.

Architecture

/mcp-server       - MCP Server with tools for product search, filter, and cart
/web-client       - React application with @mcp-ui/client integration

Features

  1. Product Search - Search products by name or keyword
  2. Category Filter - Filter by Footwear, Clothing, or Accessories
  3. Add to Cart - Add products to shopping cart
  4. Remove from Cart - Remove products from cart
  5. Cart Summary - View cart total and items
  6. AI Assistant - Chat with OpenAI-powered AI to help with shopping

Tech Stack

  • Frontend: React 18 + TypeScript + Vite
  • MCP: @modelcontextprotocol/sdk, @mcp-ui/client
  • AI: OpenAI API
  • Design: Custom CSS with modern e-commerce styling

Quick Start

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

  1. Install root dependencies:

    npm install

  2. Install server dependencies:

    cd mcp-server
npm install
cd ..

  3. Install client dependencies:

    cd web-client
npm install
cd ..

Running the Application

Option 1: Run both servers (recommended)

npm run dev

This will start:

Option 2: Run separately

Terminal 1 - MCP Server:

cd mcp-server
npm run dev

Terminal 2 - Web Client:

cd web-client
npm run dev

OpenAI API Setup

To use the AI assistant with OpenAI:

  1. Get an API key from https://platform.openai.com/.

  2. Create mcp-server/.env from mcp-server/.env.example and set:

     OPENAI_API_KEY=your-actual-api-key
 OPENAI_MODEL=gpt-4o-mini
API_PORT=8787

  3. (Optional) Create web-client/.env from web-client/.env.example if you need to override the proxy base URL.

The application still works in demo mode without an API key, using fallback responses.

MCP Tools

The server provides the following tools:

Tool Description
search_products Search products by name/keyword
filter_products Filter by category
add_to_cart Add product to cart
remove_from_cart Remove product from cart
get_cart Get cart contents
get_products Get all products
get_categories Get all categories

Mock Products

ID Name Category Price
1 Nike Shoes Footwear ₹4,999
2 Adidas T-Shirt Clothing ₹1,999
3 Puma Cap Accessories ₹999
4 Nike Jacket Clothing ₹3,999
5 Adidas Sneakers Footwear ₹5,999
6 Puma Watch Accessories ₹2,999
7 Nike Bag Accessories ₹1,999
8 Adidas Shorts Clothing ₹1,499

Example Interactions

  • "Show me Nike products"
  • "What footwear do you have?"
  • "Add the Puma Watch to my cart"
  • "Show my cart"
  • "What's in my cart?"

UI Resources

The MCP server returns HTML resources for:

  • Product lists (ecommerce://products/list)
  • Cart view (ecommerce://cart/view)

These are rendered inside the chat interface for a seamless experience.

Project Structure

.
├── docs/
│   └── decision-log.md        # Architecture and implementation decisions
├── package.json              # Root package.json
├── mcp-server/
│   ├── package.json
│   └── src/
│       └── index.js          # MCP Server with tools
└── web-client/
    ├── package.json
    ├── vite.config.ts
    ├── tsconfig.json
    ├── index.html
    └── src/
        ├── main.tsx
        ├── App.tsx           # Main React app
        ├── index.css         # Styles
        └── vite-env.d.ts

Documentation

License

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About UI Demo EcomV1

How do I install UI Demo EcomV1?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is UI Demo EcomV1 safe to use with an AI agent?

Its trust score is 30 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is UI Demo EcomV1 still maintained?

The last commit was 8 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.