日本語 | English

お問い合わせ

perfetto-mcp-rsの

LLMを解析できるMCPサーバー Perfetto トレース。 ポイント クロード コード (または任意の MCP クライアント) で トレースファイル(.pftrace) / [.perfetto-trace] / [[.bin]] / … — コンテンツが縮小) プレーン言語を尋ねて下さい。 サーバは、パーフェットSQLをフードの下で実行します。, バック [[trace_processor_shell] — 最初にダウンロードした、マニュアルなし Perfetto インストールが必要です。

専用のツールは、SQLをキュレーションしました。 エージェントがPerfettoSQLを記述するカスタム解析のために、適切なstdlibモジュールに精通しました。

クイックスタート

MCP クライアント (Claude Code, Claude Desktop) を介して perfetto-mcp-rs をドライブします。 Codex、Cursor、…) — 最初にインストールします。

1. インストール — 既定のバイナリをダウンロードし、Claudeコードと/またはCodexの場合 MCP サーバーを自動的に登録します。

Claudeコード(または新しいCodexセッションを開始する)を再起動して、それをピックアップします。 ホームブライ語, 貨物、プロジェクトスコープ、直接一括ダウンロード、マニュアル登録 オプションのインストール

2. 明白な言語で尋ねて下さい:

[~/traces/scroll_jank.pftraceをロードし、トップスクロールジャンクの原因を教えてくれます。

Perfetto UI から取得した 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