Wxapp

🚀 微信小程序MCP服務端部署說明

本項目聚焦於微信小程序MCP服務端的部署，旨在為微信小程序提供登錄認證、用戶管理以及MCP代理等功能。通過自動化部署腳本和詳細的手動部署步驟，能幫助開發者高效完成服務端的部署與配置。

🚀 快速開始

服務組成

本項目包含兩個關鍵的服務端組件：

1. 登錄服務器 (LoginServer)：負責處理微信小程序的登錄認證和用戶管理工作。
2. MCP代理服務 (Package)：提供MCP (Model Context Protocol) 代理功能。

📦 安裝指南

前提條件

• Node.js 環境 (v14+)
• PM2 進程管理器
• Nginx
• 服務器需具備公網IP
• 域名（若需使用HTTPS）

部署腳本

項目配備了自動化部署腳本 deploy.sh，執行以下命令即可完成部署：

chmod +x deploy.sh
./deploy.sh

部署腳本將按以下步驟執行：

1. 創建本地構建目錄。
2. 打包服務端代碼。
3. 上傳至目標服務器。
4. 安裝依賴。
5. 配置Nginx反向代理。
6. 使用PM2啟動服務。
7. 處理環境變量配置。

環境變量配置

部署完成後，需對兩個服務的環境變量進行配置： 登錄服務器 (.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

手動部署步驟

若需手動部署，可參考以下步驟：

1. 將服務端代碼上傳至服務器。
2. 安裝依賴：

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

3. 配置環境變量。
4. 啟動服務：

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

5. 配置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通信

🔧 技術細節

故障排查

若在部署或使用過程中遇到問題，可按以下步驟進行排查：

1. 檢查服務器是否安裝了Node.js (v14+)。
2. 確保PM2和Nginx已正確安裝。
3. 查看部署腳本輸出，確認每一步操作是否成功。
4. 啟動服務後，檢查PM2進程狀態。
5. 訪問服務時，確保域名和端口配置正確。

若仍存在其他問題，請參考具體服務的日誌文件或查閱相關文檔。