Английский | 中

perfetto-mcp-rs

MCP-сервер, позволяющий анализировать LLM Следы Перфетто. Код Point Claude (или любой клиент MCP) .pftrace / .perfetto-trace / .bin / … — контент-нюхал Спросите на простом языке. Сервер запускает PerfettoSQL под капотом, поддерживаемый trace_processor_shell — загружается автоматически при первом запуске, без руководства Требуется установка Perfetto.

Выделенные инструменты кораблируют SQL; для пользовательского анализа агент пишет PerfettoSQL — направляется к правильным модулям stdlib.

Быстрый старт

Вы управляете perfetto-mcp-rs через MCP-клиент (Claude Code, Claude Desktop). Codex, Cursor, …) — сначала установите один, если у вас его нет.

1. Install — загружает предварительно построенный двоичный код и, если код Клода и/или кодекс Присутствует, автоматически регистрирует MCP-сервер:

Перезагрузите код Клода (или начните новую сессию Кодекса), чтобы забрать его. Домашнее пиво, Груз, объем проекта, прямая двоичная загрузка и ручная регистрация находятся под Установите опции.

**2. Спросите простым языком: **

Загрузите ~/traces/scroll_jank.pftrace и скажите мне причины верхнего свитка-джанка.

Своп в любой Perfetto след, который у вас есть — захваченный из интерфейса Perfetto,

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