AI导哈

性能数据转换工具

自动从PerfDog下载移动游戏性能数据并转换为Tableau可读的CSV格式的工具。

  • by kimjeonghyun225-cpu
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 kimjeonghyun225-cpu/perfdog_mcp

使用说明

PerfDog到Tableau MCP服务器

🎮 自动下载PerfDog移动游戏性能数据并将其转换为Tableau就绪的CSV格式。

🚀 特性

PerfDog服务器

  • 自动登录 具有会话持久性
  • 批量下载 PerfDog项目的Excel性能数据
  • API集成 用于案例元数据
  • 智能命名 {Device}_{Case}.xlsx

Tableau转换器

  • CSV摘要 -设备级统计数据（FPS、CPU、内存、Jank等）
  • 时间序列CSV -逐秒的绩效指标
  • 平台检测 -从设备信息中自动检测iOS/Android
  • CPU标准化 -每个平台的CPU计算正确
  • 包名称提取 -在文件名中包含应用程序包

📦 安装

快速安装

pip install git+https://github.com/kimjeonghyun225-cpu/perfdog_MCP.git

手动设置

  1. 克隆仓库

    git clone https://github.com/kimjeonghyun225-cpu/perfdog_MCP.git
cd perfdog_MCP

  2. 安装依赖项

    pip install -r requirements.txt

  3. 配置Claude桌面

    窗户： 编辑 %APPDATA%\Claude\claude_desktop_config.json

    macOS： 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json

    添加：

    {
  "mcpServers": {
    "perfdog": {
      "command": "python",
      "args": ["C:/path/to/perfdog_MCP/perfdog_mcp_server.py"]
    },
    "tableau-converter": {
      "command": "python",
      "args": ["C:/path/to/perfdog_MCP/tableau_converter_MCP.py"]
    }
  }
}

  4. 重新启动克劳德桌面

💡 用法

克劳德技能（推荐）

  1. 安装克劳德技能

    • 下载 perfdog-tableau-converter.skill
    • 上传到Claude.ai→ 设置→ 技能

  2. 与Claude一起使用

    "Convert this PerfDog project to Tableau:
https://perfdog.wetest.net/taskdata/191797/cases

Output: C:\Users\me\Desktop\tableau
Project name: PUBG_v3.8.0"

直接MCP使用

克劳德将自动：

  1. 请求PerfDog凭据（仅限第一次）
  2. 请求项目URL、输出路径和项目名称
  3. 下载所有Excel文件
  4. 转换为Tableau CSV格式
  5. 报告完成

📊 输出文件

CSV摘要(summary_{project}.csv)

设备级统计数据包括：

  • 设备信息（类型、产品、平台）
  • FPS指标（平均值、中位数、最大值、1%低）
  • 稳定性指标（MedRange、标准、平滑指数）
  • CPU和内存（平均值、峰值）
  • Jank指标（Jank、BigJank、Drop FPS）

时间序列CSV(fps_{project}.csv)

每秒测量包括：

  • FPS、CPU、内存、GPU
  • 网络（接收/发送）
  • 温度
  • 平台特定指标

🛠️ 发展

项目结构

perfdog_MCP/
├── perfdog_mcp_server.py          # PerfDog downloader MCP server
├── tableau_converter_MCP.py       # Tableau converter MCP server
├── requirements.txt               # Python dependencies
├── README.md                      # This file
└── perfdog-tableau-converter.skill # Claude Skill

依赖项

mcp>=1.0.0
aiohttp>=3.9.0
aiofiles>=23.2.0
pandas>=2.0.0
openpyxl>=3.1.0

🎯 用例

  • QA性能测试 -自动化测试数据收集
  • 版本比较 -比较不同游戏版本的性能
  • 仪表板创建 -将数据输入Tableau仪表板
  • 回归分析 -跟踪随时间变化的性能趋势

🔒 配置

会话文件和日志存储在：

  • 会议： ~/.perfdog_mcp/perfdog_session.json
  • 日志： ~/.perfdog_mcp/perfdog_downloader.log 和 tableau_converter.log
  • 下载： ~/Desktop/perfdog_downloads/

🐛 故障排除

登录失败

  • 在以下位置验证凭据https://perfdog.wetest.net
  • 检查登录 ~/.perfdog_mcp/

无法识别MCP服务器

  • 完全重新启动克劳德桌面
  • 验证中的路径 claude_desktop_config.json
  • 检查Python是否可以从命令行访问

路径问题

  • Windows：使用双反斜杠 C:\\Users\\...
  • macOS/Linux：使用正斜杠 /Users/...

📞 支持

  • GitHub问题： https://github.com/kimjeonghyun225-cpu/perfdog_MCP/issues
  • 内部： KRAFTON兼容性QA团队

📝 许可证

内部使用-KRAFTON

🙏 鸣谢

由KRAFTON兼容性QA团队开发，用于移动游戏性能测试自动化。

相关 MCP