한국어 |

---

perfetto-mcp-rs의

LLM을 분석할 수 있는 MCP 서버 Perfetto 추적. Point Claude Code (또는 MCP 클라이언트) 추적 파일 (.pftrace / .perfetto-trace / .bin] / … - 콘텐츠 보호) 및 자주 묻는 질문 서버는 두건의 밑에 PerfettoSQL을 실행하고, 뒤로 trace_processor_shell - 첫 번째 실행에서 자동으로 다운로드, 수동 없음 Perfetto 설치 필요.

전용 도구 선박 curated SQL; 사용자 정의 분석에 대 한 에이전트 쓰기 PerfettoSQL — 오른쪽 stdlib 모듈에 대 한 steered.

빠른 시작

MCP 클라이언트를 통해 perfetto-mcp-rs를 구동 (Claude Code, Claude Desktop, Codex, Cursor, …) - 당신이 그것을 가지고 있지 않는 경우 하나 먼저 설치.

1. Install - Claude Code 및/또는 Codex를 다운로드한 경우 미리 만들어진 바이너리를 다운로드합니다. 현재 MCP 서버가 자동으로 등록됩니다.

Restart Claude Code (또는 새로운 Codex 세션을 시작합니다)를 선택합니다. 홈 양조장, 화물, 프로젝트 범위, 직접적인 다운로드 및 수동 등록은 아래에 있습니다 옵션 설치.

2. 일반 언어에 대해:

Load ~/traces/scroll_jank.pftrace와 상위 scroll-jank 원인을 말해줍니다.

모든 Perfetto 추적에서 교환 - Perfetto UI에서 캡처,

English | 简体中文

---

perfetto-mcp-rs

An MCP server that lets LLMs analyze Perfetto traces. Point Claude Code (or any MCP client) at a trace file (.pftrace / .perfetto-trace / .bin / … — content-sniffed) and ask in plain language. The server runs PerfettoSQL under the hood, backed by trace_processor_shell — downloaded automatically on first run, no manual Perfetto install required.

Dedicated tools ship curated SQL; for custom analysis the agent writes PerfettoSQL — steered toward the right stdlib modules.

Quick start

You drive perfetto-mcp-rs through an MCP client (Claude Code, Claude Desktop, Codex, Cursor, …) — install one first if you don’t have it.

1. Install — downloads the prebuilt binary and, if Claude Code and/or Codex are present, registers the MCP server automatically:

# Linux / macOS / Windows (Git Bash, MSYS2, Cygwin)
curl -fsSL https://raw.githubusercontent.com/tooluse-labs/perfetto-mcp-rs/main/install.sh | sh

# Windows (PowerShell)
irm https://raw.githubusercontent.com/tooluse-labs/perfetto-mcp-rs/main/install.ps1 | iex

Restart Claude Code (or start a new Codex session) to pick it up. Homebrew, Cargo, project scope, direct-binary download, and manual registration are under Install options.

2. Ask in plain language:

Load ~/traces/scroll_jank.pftrace and tell me the top scroll-jank causes.

Swap in any Perfetto trace you have — captured from the Perfetto UI, chrome://tracing, or record_android_trace.

The agent calls load_trace, sees it’s a Chrome trace, and reaches for the dedicated chrome_scroll_jank_summary tool — no SQL to hand-write. When a question falls outside the dedicated tools, it drops down to execute_sql with raw PerfettoSQL on the same trace.

Works best with agentic clients (Claude Code, Codex, Claude Desktop, Cursor) that chain multi-turn tool calls and follow the server’s error-message nudges. Non-agentic clients see the same tools and error nudges, but won’t chain the guided flow automatically.

Tools