FastMCP_RecSys

这是一个基于 CLIP 的时尚推荐系统，使用了 MCP。以下是项目的文件夹结构：

/project-root
│
├── /backend
│   ├── Dockerfile                # 后端 Dockerfile
│   ├── /app
│   │   ├── main.py               # FastAPI 应用代码
│   │   └── requirements.txt      # 后端的 Python 依赖
│   └── .env                      # 环境变量 (请确保将其添加到 .gitignore)
│
├── /frontend
│   ├── Dockerfile                # 前端 Dockerfile
│   ├── package.json              # Node.js 依赖 (用于 React)
│   ├── package-lock.json         # React 依赖的锁定文件
│   ├── /public
│   │   └── index.html            # 前端的 HTML 文件 (React 应用挂载于此)
│   ├── /src
│   │   ├── App.js                # 主要的 React 组件
│   │   └── index.js              # React 入口点
│   ├── tailwind.config.js        # Tailwind CSS 配置
│   ├── postcss.config.js         # PostCSS 配置
│   └── .env                      # 前端环境变量 (添加到 .gitignore)
│
├── .gitignore                    # Git 忽略文件 (包含 .env, node_modules 等)
├── docker-compose.yml            # Docker Compose 配置
└── README.md                     # 项目文档

步骤 1

更新 mongo 服务以添加相同的凭据：

  mongo:
    image: mongo:latest
    ports:
      - "27017:27017"
    environment:
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: example
    volumes:
      - mongo-data:/data/db

注意：由于在 FastAPI 应用中使用环境变量，Mongo URL 应该如下所示： MONGO_URL = "mongodb://root:example@mongo:27017"

运行后，打开浏览器并访问 👉 http://localhost:8081

使用以下信息登录：用户名：root / 密码：example (临时设置)

步骤 2:

docker-compose up --build

这将：

• 启动带有热重载的 FastAPI 后端
• 启动 MongoDB
• 启动 Mongo Express (用于 DB UI) (前端不会在此模式下自动构建)

步骤 3:

• 访问前端 (React 应用) 地址： http://localhost:3000
• 访问后端 (FastAPI 应用) 地址： http://localhost:8000

📌 快速提示

访问您的应用：http://localhost:8000/docs

查看 MongoDB UI：http://localhost:8081 (使用用户：root，密码：example)

mongo-seed 仅在启动时运行一次，以填充您的 tags 集合。

📌 UI 的示例组件

1. 图片上传
2. 提交按钮
3. 显示服装标签 + 推荐