SSE微信小程序

What is SSE微信小程序?

SSE微信小程序是一个基于微信小程序的SSE（Server-Sent Events）客户端，集成了MCP（Model Context Protocol）代理服务。它主要面向需要在微信生态中实现实时聊天和工具调用（如高德地图天气查询）的开发者，提供社区精选、实时对话、用户认证与聊天次数管理等功能。

How to use SSE微信小程序?

1. 启动后端服务器：运行 npm run start-server（默认端口3091）。2. 使用微信开发者工具打开项目，在“详情”→“本地设置”中勾选“不校验合法域名”。3. 确保服务器运行正常，即可在模拟器或真机中预览。需配置 .env 中的 OPENAI_API_KEY、WX_APPID 等环境变量。

Key features of SSE微信小程序

• 社区精选页面：展示MCP应用和热门推荐
• 聊天页面：基于SSE的实时聊天，支持高德地图等工具
• 个人信息页面：微信登录、登出及聊天次数管理
• SSE实时通信：服务器主动推送消息至客户端
• 工具调用流程：完整识别、解析、执行和结果渲染
• 用户认证系统：微信账户登录，赠送并消耗聊天次数

Use cases of SSE微信小程序

• 在微信小程序中搭建实时AI聊天助手
• 集成MCP服务（如天气查询、地图）提供智能交互
• 社区内容推荐与精选展示
• 用户登录与用量控制场景（聊天次数管理）

FAQ from SSE微信小程序

需要哪些运行环境？

微信小程序端需要微信开发者工具；服务器端需要Node.js v14+、PM2进程管理器及Nginx（如需HTTPS）。SSE连接要求服务器支持跨域。

如何配置环境变量？

复制 .env.example 为 .env，填入 OPENAI_API_KEY（OpenAI密钥）、WX_APPID 和 WX_SECRET（微信小程序凭证）等参数。

聊天次数如何管理？

用户首次登录自动获赠200次聊天额度，每次对话消耗1次。次数在个人页面和聊天页面实时显示，数据存储于微信云开发数据库。

支持哪些通信协议？

主要使用SSE（服务端推送）进行实时聊天，同时提供常规HTTP POST接口（POST /chat）用于非流式请求。

用户认证方式是什么？

通过微信小程序官方的 wx.getUserProfile API 获取用户信息完成登录，支持退出登录。后端使用JWT管理会话。