Wxapp

🚀 微信小程序MCPサーバーサイドのデプロイ説明

このプロジェクトは、微信小程序のMCPサーバーサイドのデプロイに関する説明を提供します。主にサービスの構成、デプロイ方法、各サービスの機能、トラブルシューティングなどについて解説します。

✨ 主な機能

このプロジェクトには、2つの主要なサーバーサイドコンポーネントが含まれています。

• ログインサーバー (LoginServer) - 微信小程序のログイン認証とユーザー管理を処理します。
• 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. 環境変数の設定を処理します。

環境変数の設定

デプロイが完了した後、2つのサービスの環境変数を設定する必要があります。 ログインサーバー (.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. サービスにアクセスする際、ドメインとポートの設定が正しいことを確認します。

その他の問題がある場合は、具体的なサービスのログファイルを参照するか、関連ドキュメントを確認してください。