perfetto-mcp-rs은(는) 무엇을 하나요?
MCP를 통한 Perfetto 트레이스 분석 — PerfettoSQL 쿼리 및 스크롤 지연, 페이지 로드, 메인 스레드 핫스팟 전용 Chrome 도구
개요
이 MCP(Model Context Protocol) 서버는 AI 에이전트가 Perfetto 트레이스 파일(.perfetto-trace, .trace) 또는 ADB(Android Debug Bridge)를 통해 실시간으로 수집된 트레이스를 분석할 수 있도록 합니다. PerfettoSQL을 지원하여 복잡한 쿼리를 실행하고, Chrome 브라우저의 성능 문제(스크롤 지연, 페이지 로드 시간, 메인 스레드 핫스팟)를 진단하는 전용 도구를 제공합니다.
기능
- PerfettoSQL 쿼리 실행: 커스텀 SQL 쿼리를 Perfetto 트레이스 데이터베이스에 실행합니다.
- Chrome 스크롤 지연 분석: 스크롤 중 발생하는 프레임 드롭, 지연 시간, 원인 식별
- Chrome 페이지 로드 분석: 페이지 로드 타이밍, 주요 성능 지표(LCP, FCP 등) 분석
- 메인 스레드 핫스팟 분석: CPU 사용률이 높은 함수 및 호출 스택 식별
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 MCP 호환 AI 어시스턴트
설치
사전 요구 사항
- Rust (최신 안정 버전)
- Perfetto (선택 사항, 실시간 트레이싱에 필요)
설치 및 실행
# 저장소 클론
git clone https://github.com/tooluse-labs/perfetto-mcp-rs.git
cd perfetto-mcp-rs
# 빌드
cargo build --release
# MCP 서버 실행 (트레이스 파일로 분석)
./target/release/perfetto-mcp --trace /path/to/trace.perfetto-trace
# 또는 ADB를 통해 실시간 트레이싱
./target/release/perfetto-mcp --adb
사용 예시
MCP 설정 (Claude Code)
~/.claude/settings.json 파일에 추가:
{
"mcpServers": {
"perfetto": {
"command": "/path/to/perfetto-mcp",
"args": ["--trace", "/path/to/trace.perfetto-trace"],
"env": {}
}
}
}
AI 에이전트 명령 예시
- "이 트레이스에서 스크롤 지연을 분석해 줘"
- "페이지 로드 중 가장 오래 걸린 단계는 무엇인가요?"
- "메인 스레드에서 가장 많은 CPU를 사용한 함수를 찾아줘"
- "PerfettoSQL로 sched_switch 이벤트를 쿼리해 줘"
라이선스
MIT