JinDaGe - wxapp MCP Details

article

README

🚀 微信小程序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进程状态。
访问服务时，确保域名和端口配置正确。

若仍存在其他问题，请参考具体服务的日志文件或查阅相关文档。

wxapp