wedata-mcp

微信小程序数据分析 MCP Server，通过 Model Context Protocol 为 AI 助手提供微信小程序性能监控与 JS 错误分析能力。

数据来源于微信小程序数据助手（WeData）平台。

功能

登录认证

• login - 微信扫码登录（终端显示二维码）
• check_session - 检查当前登录状态

性能监控

• get_performance_report - 综合性能评估报告（核心指标、业务影响、网络错误分布）
• get_launch_open_rate - 启动打开率分析（冷启动漏斗、各场景打开率、趋势）
• get_launch_cost - 启动耗时分析（各阶段耗时、分布、趋势）
• get_launch_download - 代码包下载分析（下载耗时、包大小、趋势）
• get_network_performance - 网络性能（请求失败率、延迟概览、Top 接口、失败类型分布）
• get_runtime_performance - 运行时性能（页面切换耗时、运行时异常、内存分析）
• get_tiyan_overview - 体验指标（卡顿率、INP、CLS、暴力点击、分页面详情）
• get_tiyan_blank_screen - 白屏分析（发生次数/占比、分页面详情）
• get_weekly_performance_stats - 周维度聚合统计（含同行对比）

JS 错误分析

• get_js_errors - 错误列表（错误内容、次数、影响用户数，支持按时间/版本/类型筛选）
• get_js_error_detail - 错误详情（错误堆栈、用户数、错误数）
• get_js_error_distribution - 错误分布（按系统、客户端版本、基础库版本、机型）

快速开始

添加到 AI 客户端

支持的客户端：claude、codex、cursor、windsurf、gemini

全局安装（推荐，所有项目可用）：

npx wedata-mcp add claude -g
npx wedata-mcp add codex -g

项目级安装（仅当前项目生效）：

npx wedata-mcp add claude
npx wedata-mcp add cursor

使用流程

1. 调用 login 工具，终端会显示二维码
2. 使用微信扫码完成登录
3. 调用 check_session 确认登录状态
4. 使用性能监控或错误分析工具获取数据

登录状态会持久化到 ~/.wedata-mcp/，后续会话无需重复登录。

CLI 命令

| 命令 | 说明 | |------|------| | npx wedata-mcp add <client> -g | 全局添加到 AI 客户端 | | npx wedata-mcp add <client> | 添加到当前项目 | | npx wedata-mcp update | 检查并升级到最新版本 | | npx wedata-mcp serve | 手动启动 MCP Server |

本地开发

pnpm install
pnpm build

本地调试时可使用开发模式：

{
  "mcpServers": {
    "wedata": {
      "command": "npx",
      "args": ["tsx", "/path/to/wedata-mcp/src/index.ts"]
    }
  }
}

技术栈

• TypeScript + Node.js (ESM)
• @modelcontextprotocol/sdk - MCP 协议实现
• Playwright - 浏览器自动化
• Zod - 参数校验

License

MIT