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 • 问题反馈 • 文档