Perfetto MCP

🚀 Perfetto MCP

將自然語言轉化為強大的Perfetto跟蹤分析工具

Perfetto MCP是一個模型上下文協議（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"]
    }
  }
}

# 添加到用戶範圍
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

📖 如何使用

示例起始提示：

在Perfetto跟蹤中，我發現FragmentManager執行耗時438ms。你能找出耗時如此之久的原因嗎？

必需參數

每個工具都需要以下兩個輸入：

在你的提示中

明確指定跟蹤文件和進程，在提示前加上： "使用Perfetto跟蹤文件 /absolute/path/to/trace.perfetto-trace 分析進程 com.example.app"

可選過濾器

許多工具支持額外的過濾條件（可讓大語言模型處理）：

• time_range：{start_ms: 10000, end_ms: 25000}
• 特定工具的閾值：min_block_ms、jank_threshold_ms、limit

🛠️ 可用工具

🔎 探索與發現

🚨 ANR分析

注意：如果記錄的跟蹤文件包含ANR事件，此功能將非常有用。

🎯 性能分析

📱 UI性能分析

🔒 併發與IPC分析

💾 內存分析

輸出格式

所有工具都返回結構化的JSON數據，包含：

• 摘要：高層次的分析結果。
• 詳情：特定工具的分析結果。
• 元數據：執行上下文和使用的任何回退信息。

📚 資源

• 跟蹤處理器Python API - Perfetto的Python接口。
• Perfetto SQL語法 - 自定義查詢的SQL參考。

📄 許可證

本項目採用Apache 2.0許可證。詳情請參考 LICENSE。

GitHub • 問題反饋 • 文檔