使用说明
MCP服务端部署指南(GitHub + Render)
这个仓库包含MCP服务端的前端页面和后端代码,可通过以下步骤部署到线上,实现公开访问。
一、准备工作
- 注册GitHub账号:https://github.com/
- 注册Render账号:https://render.com/(用于部署后端服务,免费版足够)
二、部署静态前端页面(GitHub Pages)
步骤1:创建GitHub仓库
- 登录GitHub,点击右上角「+」→「New repository」。
- 仓库名填写:
mcp-javascript-deploy(或自定义)。 - 勾选「Public」和「Add a README file」,点击「Create repository」。
步骤2:上传前端文件
- 进入仓库,点击「Add file」→「Upload files」。
- 上传本仓库的
frontend/public_promo.html文件。
步骤3:启用GitHub Pages
- 仓库页面点击「Settings」→ 左侧「Pages」。
- 在「Source」处选择「main」分支,「/ (root)」,点击「Save」。
- 等待1分钟,刷新页面,会显示你的前端页面地址(如:
https://用户名.github.io/mcp-javascript-deploy/public_promo.html)。
三、部署后端服务(Render)
步骤1:上传后端代码到GitHub
- 在你的GitHub仓库中,点击「Add file」→「Create new file」。
- 依次创建以下文件(复制仓库中的代码):
backend/app.jsbackend/db.jsbackend/package.json
步骤2:在Render上部署后端
- 登录Render,点击「New」→「Web Service」。
- 点击「Connect to GitHub」,授权访问你的仓库,选择
mcp-javascript-deploy。 - 配置部署信息:
- Name:自定义(如
mcp-js-server) - Root Directory:填写
backend(指定后端代码目录) - Build Command:
npm install(安装依赖) - Start Command:
node app.js(启动服务)
- Name:自定义(如
- 点击「Create Web Service」,等待部署完成(约1分钟)。
- 部署成功后,会生成一个后端域名(如:
https://mcp-js-server.onrender.com)。
四、关联前端和后端
- 打开GitHub仓库中的
frontend/public_promo.html,点击「Edit」。 - 找到代码中的
const BACKEND_URL = "https://你的后端服务域名.onrender.com",替换为你的Render后端域名。 - 点击「Commit changes」保存。
五、测试访问
- 前端页面:访问GitHub Pages生成的地址,能看到优惠列表卡片。
- 后端接口:访问
https://你的后端域名.onrender.com/api/mcp/jutuike/public_promo_list,能看到JSON格式的优惠数据。
常见问题
- 前端页面加载失败:检查
BACKEND_URL是否正确,Render后端是否部署成功。 - 后端接口返回404:检查代码中的接口路径是否正确,Render部署时「Root Directory」是否填了
backend。 - 免费版Render服务会休眠:30分钟无访问会暂停,下次访问需等待几秒唤醒(不影响功能)。
