Perfetto MCP

🚀 Perfetto MCP

自然言語を強力なPerfettoトレース分析に変換します。

Model Context Protocol (MCP)サーバーで、自然言語のプロンプトを焦点を絞ったPerfetto分析に変換します。SQLを記述することなく、ジャンクの説明、ANRの診断、CPUのホットスレッドの特定、ロック競合の発見、メモリリークの検出などをすばやく行うことができます。

✨ 主な機能

• 自然言語 → SQL：平易な英語で質問を投げかけると、正確なPerfettoクエリが得られます。
• ANR検出：自動的にアプリケーションの応答なし（ANR）イベントを識別して分析します。
• パフォーマンス分析：CPUプロファイリング、フレームジャンク検出、メモリリーク検出を行います。
• スレッド競合：同期のボトルネックとロック競合を見つけます。
• Binderプロファイリング：IPCのパフォーマンスと低速なシステム間の相互作用を分析します。

📋 前提条件

• Python 3.13+ (macOS/Homebrew):

  brew install python@3.13
  

• 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"]

ローカルインストール (開発サーバー)

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

📖 使い方

例としての最初のプロンプト：

In the perfetto trace, I see that the FragmentManager is taking 438ms to execute. Can you figure out why it's taking so long?

必須パラメータ

すべてのツールには、以下の2つの入力が必要です。

プロンプトでの注意点

トレースとプロセスについて明確にするため、プロンプトの先頭に次のように付けます。

"Use perfetto trace /absolute/path/to/trace.perfetto-trace for process com.example.app"

オプションのフィルター

多くのツールは追加のフィルタリングをサポートしています（ただし、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です。詳細はLICENSEを参照してください。

GitHub • Issues • Documentation