Perfetto

Perfetto MCP

自然言語から強力な Perfetto トレース分析を実現

自然言語のプロンプトを、対象を絞った Perfetto 分析に変換する Model Context Protocol（MCP）サーバーです。SQL を書かずに、ジャンクの原因をすばやく説明し、ANR を診断し、CPU を多く使うスレッドを特定し、ロック競合を明らかにし、メモリリークを検出できます。

✨ 機能

• 自然言語 → SQL：平易な英語で質問すると、正確な Perfetto クエリが得られます
• ANR 検出：Application Not Responding イベントを自動で特定して分析します
• パフォーマンス分析：CPU プロファイリング、フレームジャンクの検出、メモリリークの検出
• スレッド競合：同期処理のボトルネックやロック競合を特定します
• Binder プロファイリング：IPC のパフォーマンスや、応答の遅いシステムとのやり取りを分析します

📋 前提条件

• Python 3.13+（macOS/Homebrew）：

  brew install [email protected]
  

• uv（推奨）：

  brew install uv
  

🚀 はじめに

{
  "mcpServers": {
    "perfetto-mcp": {
      "command": "uvx",
      "args": ["perfetto-mcp"]
    }
  }
}

# Add to user scope
claude mcp add perfetto-mcp --scope user -- uvx perfetto-mcp

{
  "mcpServers": {
    "perfetto-mcp": {
      "command": "uvx",
      "args": ["perfetto-mcp"]
    }
  }
}

{
  "mcpServers": {
    "perfetto-mcp": {
      "command": "uvx",
      "args": ["perfetto-mcp"]
    }
  }
}

[mcp_servers.perfetto-mcp]
command = "uvx"
args = ["perfetto-mcp"]

オプション：ローカルの trace_processor_shell バイナリを使用する

ネットワーク環境でダウンロードがブロックされる場合は、 PERFETTO_MCP_TRACE_PROCESSOR_BIN_PATH にローカルの trace_processor_shell バイナリの絶対パスを設定します。

この環境変数が設定されている場合、perfetto-mcp はそのバイナリを直接使用します。 設定されていない場合は、既定の perfetto Python の動作がそのまま使われます。

例（mcp.json）：

{
  "mcpServers": {
    "perfetto-mcp": {
      "command": "uvx",
      "args": ["perfetto-mcp"],
      "env": {
        "PERFETTO_MCP_TRACE_PROCESSOR_BIN_PATH": "D:/tools/perfetto/trace_processor_shell.exe"
      }
    }
  }
}

例（~/.codex/config.toml）：

[mcp_servers.perfetto-mcp]
command = "uvx"
args = ["perfetto-mcp"]
[mcp_servers.perfetto-mcp.env]
PERFETTO_MCP_TRACE_PROCESSOR_BIN_PATH = "D:/tools/perfetto/trace_processor_shell.exe"

ローカルインストール（開発サーバー）

cd perfetto-mcp-server
uv sync
uv run mcp dev src/perfetto_mcp/dev.py

{
  "mcpServers": {
    "perfetto-mcp-local": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/git/repo/perfetto-mcp",
        "run",
        "-m",
        "perfetto_mcp"
      ],
      "env": { "PYTHONPATH": "src" }
    }
  }
}

pip3 install perfetto-mcp
python3 -m perfetto_mcp

📖 使い方

プロンプトの例：

Perfetto トレースを見ると、FragmentManager の実行に 438ms かかっています。時間がかかっている原因を特定できますか？

必須パラメーター

すべてのツールに、次の 2 つの入力が必要です：

プロンプトでの指定

トレースとプロセスを明示し、プロンプトの先頭に次の文を付けてください：

"プロセス com.example.app の Perfetto トレース /absolute/path/to/trace.perfetto-trace を使用してください"

オプションのフィルター

多くのツールは追加のフィルタリングに対応しています（ただし、LLM に任せてください）：

• time_range：{start_ms: 10000, end_ms: 25000}
• ツール固有のしきい値：min_block_ms、jank_threshold_ms、limit

🛠️ 利用可能なツール

🔎 探索と検出

🚨 ANR 分析

注：記録されたトレースに ANR が含まれている場合に役立ちます

🎯 パフォーマンスプロファイリング

📱 UI パフォーマンス

🔒 並行処理と IPC

💾 メモリ分析

出力形式

すべてのツールは、次の項目を含む構造化 JSON を返します。

• Summary：主な調査結果
• Details：ツール固有の結果
• Metadata：実行コンテキストと使用されたフォールバック

📚 リソース

• Trace Processor Python API - Perfetto の Python インターフェース
• Perfetto SQL Syntax - カスタムクエリ用の SQL リファレンス

📄 ライセンス

Apache 2.0 ライセンス。詳細は LICENSE を参照してください。

GitHub • Issues • ドキュメント