微生活会员 MCP

WorkBuddy 连接器，自动登录微生活管理系统(manage.acewill.net)，查询会员、储值、消费、优惠券、营销活动等全维度经营数据。

✨ 特点

• 零配置 — 无需 API Key、无需管理员，安装即用
• 自动登录 — 首次使用弹出 Chrome 浏览器，登录后 Cookie 自动保存
• 免安装浏览器 — 自动检测系统已有的 Chrome/Edge，不下载额外软件
• 22个报表 — 储值、消费、优惠券、会员、营销、积分全覆盖

🚀 安装

1. 安装依赖（国内镜像加速）

# 方式A：一键安装（推荐）
bash install.sh

# 方式B：手动安装
pip install -i https://mirrors.cloud.tencent.com/pypi/simple -r requirements.txt

国内可用镜像源：

镜像	地址
腾讯云	https://mirrors.cloud.tencent.com/pypi/simple
清华	https://pypi.tuna.tsinghua.edu.cn/simple
阿里云	https://mirrors.aliyun.com/pypi/simple

2. 配置 WorkBuddy

打开 ~/.workbuddy/mcp.json，添加：

{
  "mcpServers": {
    "微生活会员": {
      "type": "stdio",
      "command": "python3",
      "args": ["路径/server.py"],
      "description": "微生活会员系统数据分析"
    }
  }
}

3. 刷新 WorkBuddy 连接器 → 信任 → 开始使用

🔄 更新到最新版本

cd 安装目录/welife-mcp
bash update.sh
# 或直接: bash install.sh （自动先 git pull）

WorkBuddy 下次调用 MCP 时自动加载新代码，无需重启。

📊 可用报表

分类	报表
储值	储值流水、储值统计
消费	消费流水
优惠券	卡券汇总、券门店核销汇总、券统计分析、券核销明细、券码核销、商城券核销
会员	会员复购、会员等级分析、会员画像、会员发展汇总
营销	营销活动统计
积分	积分统计
其他	日常统计、二维码统计、会员等级售卖、储值卡售卖、手工调账

🛠 可用工具

工具	说明
login	弹出浏览器登录微生活后台
report	直接访问指定报表（传入报表名称）
fetch	访问任意页面提取数据
dashboard	首页仪表盘 KPI
check	检查登录状态
logout	退出登录

💡 使用示例

"登录微生活"           → 弹出 Chrome 完成登录
"查储值统计"           → 按门店查看储值汇总表
"券门店核销汇总"       → 各门店优惠券使用情况
"6月 vs 5月储值对比"   → 自动筛选月份对比计算
"最近一季度营销活动"    → 活动效果分析报告
"查会员手机号138xxx"   → 搜索指定会员信息
"我的储值余额"         → 查看储值余额
"消费记录"             → 查看消费明细
"会员等级分析"         → 会员结构分析

🎯 支持的操作技能（7大类 50+ 操作）

会员管理

会员列表、会员查询、会员详情、会员卡/开卡/批量开卡、储值充值/批量充值、储值余额、消费记录、积分管理/批量积分、会员等级/升降级、会员分组、会员标签、会员注销/锁定/审核、会员还款

卡券管理

优惠券列表、新建优惠券、券包管理、发券记录

营销活动

活动列表、新建活动、消费有礼、积分活动、裂变活动、秒杀活动、开卡关怀、精准营销、定向发券、评价有礼、签到活动、拼团活动、活动统计、消息推送

数据分析报表（22个）

储值流水/统计、消费流水、卡券汇总/核销明细、券门店核销汇总、会员复购/等级分析/画像、营销活动统计、积分统计等

机构管理

门店管理、员工管理、角色权限

运营工具

二维码管理、消息管理、自动回复、商城管理

📁 文件结构

welife-mcp/
├── server.py          # MCP 主服务（7个工具）
├── browser.py         # 浏览器 + HTTP 客户端
├── reports.py         # 22个报表 URL
├── skills.py          # 7大类 50+ 操作技能定义
├── install.sh         # 一键安装脚本
├── cookies/           # Cookie 本地存储
└── requirements.txt   # Python 依赖