Apppublic

CynthiaOmovoiye/meridian-support-bot

sourceHugging Faceupdated 5mo agoView on Hugging Face

0likes

App README

Meridian Electronics — AI Support Chatbot

A production-ready prototype of an AI-powered customer support and shopping assistant for Meridian Electronics, built for the GenAI bootcamp MCP assessment.

GitHub repository: https://github.com/CynthiaOmovoiye/meridian-support-bot

Architecture

—UI: Streamlit with a luxury e-commerce design — sidebar AI concierge + Shop / Cart / Orders tabs
—LLM: OpenRouter (gpt-4o-mini) with native tool-calling in an agentic loop — the LLM discovers and calls MCP tools directly
—MCP: Streamable HTTP MCP client connecting to https://order-mcp-74afyau24q-uc.a.run.app/mcp
—Caching: Session-scoped TTL cache (2–5 min for products, 30 s for orders) — reduces MCP round-trips and latency
—Security: Auth-gated tools, input sanitisation, email masking, no PIN in LLM context

MCP Tools Used

Tool	Purpose
`search_products`	Free-text product search
`list_products`	Browse by category
`get_product`	Full product details by SKU
`verify_customer_pin`	Authenticate returning customers
`get_customer`	Customer profile (authenticated)
`list_orders`	Order history (authenticated)
`get_order`	Order detail (authenticated)
`create_order`	Place order with UI confirmation gate

Hugging Face Spaces — Secrets

Set these in Settings → Variables and secrets → New secret:

Secret	Required	Description
`OPENROUTER_API_KEY`	Yes	Your OpenRouter API key
`MCP_SERVER_URL`	No	Defaults to the assessment server URL
`OPENROUTER_MODEL`	No	Defaults to `openai/gpt-4o-mini`
`LANGFUSE_PUBLIC_KEY`	No	Optional observability
`LANGFUSE_SECRET_KEY`	No	Optional observability
`LANGFUSE_HOST`	No	Defaults to `https://cloud.langfuse.com`

Local Development

bash

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env          # add your OPENROUTER_API_KEY
streamlit run app.py