perfetto-mcp

> Turn natural language into powerful Perfetto trace analysis

A Model Context Protocol (MCP) server that transforms natural-language prompts into focused Perfetto analyses. Quickly explain jank, diagnose ANRs, spot CPU hot threads, uncover lock contention, and find memory leaks – all without writing SQL.

• Natural Language → SQL: Ask questions in plain English, get precise Perfetto queries
• ANR Detection: Automatically identify and analyze Application Not Responding events
• Performance Analysis: CPU profiling, frame jank detection, memory leak detection
• Thread Contention: Find synchronization bottlenecks and lock contention
• Binder Profiling: Analyze IPC performance and slow system interactions

• Python 3.13+ (macOS/Homebrew):

  brew install python@3.13

• uv (recommended):

  brew install uv

<details> <summary><strong>Cursor</strong></summary>

[](https://cursor.com/install-mcp?name=perfetto-mcp&config=eyJjb21tYW5kIjoidXZ4IHBlcmZldHRvLW1jcCJ9)

Or add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

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

</details>

<details> <summary><strong>Claude Code</strong></summary>

Run this command. See Claude Code MCP docs for more info.

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

Or edit ~/claude.json (macOS) or %APPDATA%\Claude\claude.json (Windows):

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

</details>

<details> <summary><strong>VS Code</strong></su