perfetto-mcp

概述

Perfetto MCP 是一个专用的 MCP 服务器，允许开发者使用自然语言提示分析 Android 性能跟踪。它将普通英文问题转换为精确的 Perfetto SQL 查询，使用户能够诊断 ANR、查找 CPU 瓶颈、检测 UI 卡顿、分析内存泄漏和调查 binder 事务，而无需编写 SQL。该服务器支持多种 MCP 集成，包括 Cursor、Claude Code、VS Code 和 Codex，并提供 uvx 和 pip 安装选项。

试试问 AI

装完之后，这里有 6 个你可以让 AI 做的事：

• find_slices

  Survey slice names and locate hot paths

  试试:Find slice names containing 'Choreographer' and show top examples
• execute_sql_query

  Run custom PerfettoSQL for advanced analysis

  试试:Run custom SQL to correlate threads and frames in the first 30s
• detect_anrs

  Find ANR events with severity classification

  试试:Detect ANRs in the first 10s and summarize severity
• anr_root_cause_analyzer

  Deep-dive ANR causes with ranked likelihood

  试试:Analyze ANR root cause around 20,000 ms and rank likely causes
• cpu_utilization_profiler

  Thread-level CPU usage and scheduling

  试试:Profile CPU usage by thread and flag the hottest threads
• main_thread_hotspot_slices

  Find longest-running main thread operations

  试试:List main-thread hotspots >50 ms during 10s–25s
• detect_jank_frames

  Identify frames missing deadlines

  试试:Find janky frames above 16.67 ms and list the worst 20
• frame_performance_summary

  Overall frame health metrics

  试试:Summarize frame performance and report jank rate and P99 CPU time
• thread_contention_analyzer

  Find synchronization bottlenecks

  试试:Find lock contention between 15s–30s and show worst waits
• binder_transaction_profiler

  Analyze Binder IPC performance

  试试:Profile slow Binder transactions and group by server process
• memory_leak_detector

  Find sustained memory growth patterns

  试试:Detect memory-leak signals over the last 60s
• heap_dominator_tree_analyzer

  Identify memory-hogging classes

  试试:Analyze heap dominator classes and list top offenders

可对比工具

安装

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

claude mcp add perfetto-mcp --scope user -- uvx perfetto-mcp

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

pip3 install perfetto-mcp
python3 -m perfetto_mcp

FAQ

Perfetto MCP 支持什么文件格式？

Perfetto MCP 支持 Perfetto 跟踪文件（.perfetto-trace 格式）。

我可以使用本地的 trace_processor_shell 二进制文件吗？

是的，设置 PERFETTO_MCP_TRACE_PROCESSOR_BIN_PATH 环境变量指向您的本地二进制文件路径。

我可以执行哪些类型的性能分析？

您可以使用自然语言提示分析 ANR、CPU 使用情况、帧卡顿、内存泄漏、线程争用、binder 事务等性能问题。

perfetto-mcp 对比