AI购物助手

一个AI驱动的购物助手,帮助用户通过自然语言查找商品、加入购物车并完成购买。

  • by Karanveer266
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 karanveer266/sparkathon-mcp-server-project

使用说明

沃尔玛礼宾部

一款人工智能购物助手,帮助用户找到产品,将其添加到购物车中,并使用自然语言完成购买。

特性

  • 自然语言购物:用简单的英语询问产品
  • 人工智能驱动的搜索:智能产品匹配和推荐
  • 自动购物车管理:通过对话将商品添加到购物车
  • 结账协助:在人工智能指导下完成购买

技术栈

  • 后端:Django、Django REST框架、FastAPI
  • 前端:HTML、CSS、JavaScript、TailwindCSS
  • 人工智能集成Claude AI(人类)
  • 数据库:SQLite(开发)

项目结构

  • walmart_concierge/:Django主要项目设置
  • store/:用于电子商务功能的Django应用程序
  • mcp_server/:用于AI集成的FastAPI服务器
  • templates/:HTML模板
  • static/:CSS、JavaScript和媒体文件

安装说明

先决条件

  • Python 3.9+
  • Anthropic API密钥(用于Claude AI)

安装

  1. 克隆存储库

    git clone https://github.com/Karanveer266/sparkathon-mcp-server-project.git
    cd walmart_concierge
    
  2. 创建虚拟环境

    python -m venv venv
    source venv/bin/activate  # On Windows: venv\Scripts\activate
    
  3. 安装依赖项

    pip install -r requirements.txt
    
  4. 配置环境变量

    • 复制 .env.example 向 .env
    • 添加您的Anthropic API密钥和其他设置
  5. 运行迁移

    python manage.py migrate
    
  6. 创建超级用户(可选)

    python manage.py createsuperuser
    
  7. 启动Django服务器

    python manage.py runserver
    
  8. 在单独的终端中,启动MCP服务器

    cd mcp_server
    uvicorn server:app --reload --port 8001
    
  9. 访问http://localhost:8000在您的浏览器中

用法

  1. 点击导航栏中的“AI助手”按钮
  2. 键入自然语言请求,如:
    • “给我看看700美元以下的笔记本电脑”
    • “往我的购物车里加2加仑牛奶”
    • “我需要给孩子们吃健康的零食”
    • “我的车里有什么?”
    • “查看我的订单”