perfdog_mcp
No description available
Ask AI about perfdog_mcp
Powered by Claude ยท Grounded in docs
I know everything about perfdog_mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
PerfDog to Tableau MCP Servers
๐ฎ Automate PerfDog mobile game performance data download and conversion to Tableau-ready CSV format.
๐ Features
PerfDog Server
- Auto-login with session persistence
- Bulk download Excel performance data from PerfDog projects
- API integration for case metadata
- Smart naming
{Device}_{Case}.xlsx
Tableau Converter
- Summary CSV - Device-level statistics (FPS, CPU, Memory, Jank, etc.)
- TimeSeries CSV - Second-by-second performance metrics
- Platform detection - Auto-detect iOS/Android from device info
- CPU normalization - Proper CPU calculation per platform
- Package name extraction - Include app package in filename
๐ฆ Installation
Quick Install
pip install git+https://github.com/kimjeonghyun225-cpu/perfdog_MCP.git
Manual Setup
-
Clone the repository
git clone https://github.com/kimjeonghyun225-cpu/perfdog_MCP.git cd perfdog_MCP -
Install dependencies
pip install -r requirements.txt -
Configure Claude Desktop
Windows: Edit
%APPDATA%\Claude\claude_desktop_config.jsonmacOS: Edit
~/Library/Application Support/Claude/claude_desktop_config.jsonAdd:
{ "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"] } } } -
Restart Claude Desktop
๐ก Usage
With Claude Skill (Recommended)
-
Install the Claude Skill
- Download
perfdog-tableau-converter.skill - Upload to Claude.ai โ Settings โ Skills
- Download
-
Use with 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"
Direct MCP Usage
Claude will automatically:
- Ask for PerfDog credentials (first time only)
- Request project URL, output path, and project name
- Download all Excel files
- Convert to Tableau CSV format
- Report completion
๐ Output Files
Summary CSV (summary_{project}.csv)
Device-level statistics including:
- Device info (Type, Product, Platform)
- FPS metrics (Avg, Median, Max, 1% Low)
- Stability indicators (MedRange, Std, Smooth Index)
- CPU & Memory (Avg, Peak)
- Jank metrics (Jank, BigJank, Drop FPS)
TimeSeries CSV (fps_{project}.csv)
Per-second measurements including:
- FPS, CPU, Memory, GPU
- Network (Recv/Send)
- Temperature
- Platform-specific metrics
๐ ๏ธ Development
Project Structure
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
Dependencies
mcp>=1.0.0
aiohttp>=3.9.0
aiofiles>=23.2.0
pandas>=2.0.0
openpyxl>=3.1.0
๐ฏ Use Cases
- QA Performance Testing - Automate test data collection
- Version Comparisons - Compare performance across game versions
- Dashboard Creation - Feed data into Tableau dashboards
- Regression Analysis - Track performance trends over time
๐ Configuration
Session files and logs are stored in:
- Session:
~/.perfdog_mcp/perfdog_session.json - Logs:
~/.perfdog_mcp/perfdog_downloader.logandtableau_converter.log - Downloads:
~/Desktop/perfdog_downloads/
๐ Troubleshooting
Login fails
- Verify credentials at https://perfdog.wetest.net
- Check logs in
~/.perfdog_mcp/
MCP server not recognized
- Restart Claude Desktop completely
- Verify paths in
claude_desktop_config.json - Check Python is accessible from command line
Path issues
- Windows: Use double backslashes
C:\\Users\\... - macOS/Linux: Use forward slashes
/Users/...
๐ Support
- GitHub Issues: https://github.com/kimjeonghyun225-cpu/perfdog_MCP/issues
- Internal: KRAFTON Compatibility QA Team
๐ License
Internal use - KRAFTON
๐ Credits
Developed by KRAFTON Compatibility QA Team for mobile game performance testing automation.
