fashion-inventory-mcp
Uses OpenAI's language models to interpret natural-language shopping queries and generate outfit recommendations based on real inventory data.
Provides cloud deployment for the MCP server, making the inventory search and AI agent accessible via a public endpoint.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Project 1: Fashion Inventory MCP Cloud Agent
This project is deployed on Railway. It owns the inventory flat file, searches it, and uses OpenAI to interpret natural-language shopping requirements.
Important files
cloud_agent.py: MCP server, inventory search tools, and cloud AI agent.data/inventory.json: 930 fictional fashion items across 31 categories.generate_inventory.py: reproducibly rebuilds the inventory file.railway.json: Railway start command..env.example: required variable names without real secrets.
Related MCP server: Sneaker Catalog MCP Server
Cloud AI role
The cloud AI translates language such as "black waterproof-style jacket in medium
under 150 euros" into arguments for search_inventory. Python—not AI—filters the
flat file and returns exact products, prices, sizes, and stock. The AI then selects
and explains matches without inventing inventory.
It also exposes recommend_matching_items. For a question such as "what trousers go
with a navy shirt?", the cloud AI obtains approved color pairings, searches real
trouser stock, and returns only available SKUs.
Run locally on Mac
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
cp .env.example .envAdd real values to .env, then:
python cloud_agent.pyThe local test endpoint is http://127.0.0.1:8000/mcp.
Deploy on Railway
Push the parent repository to GitHub and create a Railway service. Because this is a subfolder, configure:
Root Directory: /fashion-inventory-system/cloud-inventory-mcp
Config File Path: /fashion-inventory-system/cloud-inventory-mcp/railway.jsonAdd Railway variables:
MCP_SECRET_TOKEN=your-generated-shared-secret
OPENAI_API_KEY=your-cloud-openai-key
CLOUD_OPENAI_MODEL=gpt-4.1-miniDo not define PORT; Railway supplies it. Generate a public domain. The MCP endpoint
will be https://YOUR-SERVICE.up.railway.app/mcp.
See the parent OVERVIEW_AND_SETUP.md for the complete two-project walkthrough.
git status git add cloud_agent.py generate_inventory.py data/inventory.json README.md git commit -m "Add complete catalog and outfit recommendations" git push origin main
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search and get fashion products recommendations across multiple e-ecom stores
Live product search for AI agents across Shopify merchants and major retailers.
AI-agent product catalog: search, lookup & purchase routing over verified merchant data.
Natural-language fashion search and complete outfits from real shop pieces. Anonymous, read-only.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to browse, search, and purchase limited-edition fashion from Kenya, with tools for product details, stock checks, styling advice, and cart link generation.10MIT
- FlicenseNot gradedqualityDmaintenanceProvides tools for searching a sneaker catalog (hybrid keyword and semantic search), retrieving product details, and checking inventory stock.-
- AlicenseNot gradedqualityDmaintenanceExposes product catalog and semantic search as tools for an LLM agent, enabling natural language product recommendations based on intent rather than keyword matching.1MIT
- AlicenseAqualityBmaintenanceEnables an LLM agent to query a Shopify store's catalogue and stock via MCP, with tools for product search, product details, per-location inventory, and low-stock reports.4MIT