Wxapp

🚀 WeChat Mini Program MCP Server Deployment Instructions

This project provides a server - side deployment solution for WeChat mini - programs, aiming to simplify the deployment process and ensure the stable operation of services.

✨ Features

The project consists of two main server - side components:

1. Login Server (LoginServer) - Handles the login authentication and user management of WeChat mini - programs.
2. MCP Proxy Service (Package) - Provides MCP (Model Context Protocol) proxy functionality.

📦 Installation

Prerequisites

• Node.js environment (v14+)
• PM2 process manager
• Nginx
• The server needs to have a public IP address.
• Domain name (required for HTTPS).

Deployment Script

The project offers an automated deployment script deploy.sh. Execute the following commands for deployment:

chmod +x deploy.sh
./deploy.sh

The deployment script will:

1. Create a local build directory.
2. Package the server - side code.
3. Upload it to the target server.
4. Install dependencies.
5. Configure Nginx reverse proxy.
6. Start the service using PM2.
7. Handle environment variable configuration.

Environment Variable Configuration

After deployment, you need to configure the environment variables for the two services:

Login Server (.env)

# Service configuration
PORT=3090
NODE_ENV=production

# JWT configuration
JWT_SECRET=your_jwt_secret_here
JWT_EXPIRES_IN=7d

# WeChat mini - program configuration
WX_APPID=your_wx_appid_here
WX_SECRET=your_wx_secret_here

# Data storage configuration
DATA_DIR=data

MCP Proxy Service (.env)

# Service configuration
PORT=3091
NODE_ENV=production

# OpenAI configuration
OPENAI_API_KEY=your_openai_api_key_here
OPENAI_MODEL=gpt-4o
OPENAI_BASE_URL=https://api.openai.com/v1

Manual Deployment Steps

If you need to deploy manually, please refer to the following steps:

1. Upload the server - side code to the server.
2. Install dependencies:

   cd loginServer && npm install
   cd package && npm install && npm run build
   

3. Configure environment variables.
4. Start the services:

   cd loginServer && pm2 start app.js --name wxapp - login - server
   cd package && pm2 start dist/sse_proxy_server.js --name mcp - proxy - server
   

5. Configure Nginx reverse proxy.

Nginx Configuration Example

server {
    listen 80;
    server_name your - domain.com;

    # Login Server
    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 Proxy Service
    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;
    }
}

🔧 Technical Details

Login Server Features

• User authentication
• Session management
• Data storage

MCP Proxy Service Features

• Provide MCP protocol support
• Connect to the OpenAI API
• Support WebSocket communication

💡 Troubleshooting

1. Check if Node.js (v14+) is installed on the server.
2. Ensure that PM2 and Nginx are installed correctly.
3. Check the output of the deployment script to confirm if each step is successful.
4. After starting the services, check the PM2 process status.
5. When accessing the services, ensure that the domain name and port are configured correctly.

If you encounter other issues, please refer to the log files of the specific services or relevant documentation.