🚀 微信小程序MCP服务端部署说明
本项目聚焦于微信小程序MCP服务端的部署，旨在为微信小程序提供登录认证、用户管理以及MCP代理等功能。通过自动化部署脚本和详细的手动部署步骤，能帮助开发者高效完成服务端的部署与配置。
🚀 快速开始
服务组成
本项目包含两个关键的服务端组件：
- 登录服务器 (LoginServer)：负责处理微信小程序的登录认证和用户管理工作。
- MCP代理服务 (Package)：提供MCP (Model Context Protocol) 代理功能。
📦 安装指南
前提条件
- Node.js 环境 (v14+)
- PM2 进程管理器
- Nginx
- 服务器需具备公网IP
- 域名（若需使用HTTPS）
部署脚本
项目配备了自动化部署脚本 deploy.sh，执行以下命令即可完成部署：
chmod +x deploy.sh
./deploy.sh
部署脚本将按以下步骤执行：
- 创建本地构建目录。
- 打包服务端代码。
- 上传至目标服务器。
- 安装依赖。
- 配置Nginx反向代理。
- 使用PM2启动服务。
- 处理环境变量配置。
环境变量配置
部署完成后，需对两个服务的环境变量进行配置： 登录服务器 (.env)
# 服务配置
PORT=3090
NODE_ENV=production
# JWT配置
JWT_SECRET=your_jwt_secret_here
JWT_EXPIRES_IN=7d
# 微信小程序配置
WX_APPID=your_wx_appid_here
WX_SECRET=your_wx_secret_here
# 数据存储配置
DATA_DIR=data
MCP代理服务 (.env)
# 服务配置
PORT=3091
NODE_ENV=production
# OpenAI配置
OPENAI_API_KEY=your_openai_api_key_here
OPENAI_MODEL=gpt-4o
OPENAI_BASE_URL=https://api.openai.com/v1
手动部署步骤
若需手动部署，可参考以下步骤：
- 将服务端代码上传至服务器。
- 安装依赖：
cd loginServer && npm install
cd package && npm install && npm run build
- 配置环境变量。
- 启动服务：
cd loginServer && pm2 start app.js --name wxapp-login-server
cd package && pm2 start dist/sse_proxy_server.js --name mcp-proxy-server
- 配置Nginx反向代理。
Nginx配置示例
server {
listen 80;
server_name your-domain.com;
# 登录服务器
location /api/ {
proxy_pass http://localhost:3090;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_pragma;
proxy_no_cache if_not_modified;
}
# MCP代理服务
location / {
proxy_pass http://localhost:3091;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_pragma;
proxy_no_cache if_not_modified;
}
}
✨ 主要特性
登录服务器功能
- 用户认证
- 会话管理
- 数据存储
MCP代理服务功能
- 提供MCP协议支持
- 对接OpenAI API
- 支持WebSocket通信
🔧 技术细节
故障排查
若在部署或使用过程中遇到问题，可按以下步骤进行排查：
- 检查服务器是否安装了Node.js (v14+)。
- 确保PM2和Nginx已正确安装。
- 查看部署脚本输出，确认每一步操作是否成功。
- 启动服务后，检查PM2进程状态。
- 访问服务时，确保域名和端口配置正确。
若仍存在其他问题，请参考具体服务的日志文件或查阅相关文档。