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

1. 安装依赖项

   pip install -r requirements.txt

1. 配置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"]
       }
     }
   }

1. 重新启动克劳德桌面

💡 用法

克劳德技能（推荐）

1. 安装克劳德技能

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

1. 与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团队开发，用于移动游戏性能测试自动化。