MCP优惠活动平台部署指南
这个仓库包含完整的优惠活动展示平台,包含18个固定活动,支持获取真实推广链接,可一键部署到GitHub和Render。
一、功能说明
- 前端:静态页面展示18个优惠活动(分类、名称、描述、图片),支持点击获取真实推广链接。
- 后端:Node.js服务,提供活动列表接口和推广链接生成接口(调用聚推客API)。
- 数据:活动信息写死在代码中,确保18个活动全部展示,链接实时生成。
二、部署步骤
1. 准备工作
- 注册GitHub账号:
- 注册Render账号:https://render.com/(免费版足够)
2. 部署后端服务(Render)
步骤1:创建GitHub仓库
- 登录GitHub,点击「+」→「New repository」,仓库名填
mcp-full-deploy。 - 勾选「Public」,点击「Create repository」。
步骤2:上传后端代码
- 进入仓库,点击「Add file」→「Create new file」。
- 依次创建
backend/app.js、backend/db.js、backend/package.json,复制上面的对应代码。
步骤3:部署到Render
- 登录Render,点击「New」→「Web Service」→「Connect to GitHub」,选择你的
mcp-full-deploy仓库。 - 配置部署信息:
- Name:mcp-full-server(自定义) - Root Directory:backend - Build Command:npm install - Start Command:node app.js
- 点击「Create Web Service」,等待部署完成(约1分钟),记录生成的后端域名(如
https://mcp-full-server.onrender.com)。
3. 部署前端页面(GitHub Pages)
步骤1:上传前端代码
- 在GitHub仓库中,点击「Add file」→「Create new file」,路径填
frontend/public_promo.html。 - 复制上面的前端代码,修改
BACKEND_URL为你的Render后端域名(如https://mcp-full-server.onrender.com)。 - 点击「Commit changes」保存。
步骤2:启用GitHub Pages
- 仓库页面点击「Settings」→「Pages」→「Source」选择「main」分支,「/ (root)」。
- 点击「Save」,等待1分钟,获取前端页面地址(如
https://你的用户名.github.io/mcp-full-deploy/frontend/public_promo.html)。
三、使用说明
- 访问前端页面地址,即可看到18个活动的卡片列表。
- 点击每个卡片的「获取真实推广链接」按钮,会显示该活动的H5链接、App直达链接、小程序链接(如有)。
- 所有链接均为聚推客实时生成的有效链接,点击可直接跳转。
四、常见问题
- 链接获取失败:检查Render后端是否部署成功,或聚推客apikey是否有效(代码中已内置可用apikey)。
- 前端页面404:检查GitHub Pages配置是否正确,文件路径是否为
frontend/public_promo.html。 - 后端休眠:Render免费版30分钟无访问会休眠,首次点击链接可能需要等待3-5秒唤醒。
