Architecture
React chat UIFastAPIMCP server (tools)PostgreSQL retail schema
The problem
A retailer wanted a conversational assistant that uses real inventory and order data instead of a static FAQ, without giving the model raw database access.
Approach
- Exposed retail operations as typed MCP tools, so the model can only run approved queries.
- Built the FastAPI backend and React chat front end, deployed on AWS EC2.
- Automated build and deploy with a GitHub Actions CI/CD pipeline.
Outcome
- The model never sees credentials or writes free-form SQL — every data access goes through a reviewed tool.
- Push-to-deploy pipeline for fast iteration during the proof of concept.