How do I install the rr mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

SSyncDev

Start a project

Rr MCP Server

MCP server for orchestrating multi-process rr debugging sessions

Local serverstdioPython

What is the Rr MCP Server?

MCP server for orchestrating multi-process rr debugging sessions

The short version

MCP (Model Context Protocol) server for orchestrating multi-process rr debugging sessions.

rr-mcp enables AI agents (like Claude) to debug multi-process applications using rr's record-and-replay capabilities. It provides:

What it needs from you

Linux (rr only runs on Linux) - Python 3.11+ - rr installed and in PATH - An rr recording to debug

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
traces_list	List all available rr recordings on the system
trace_info	Get metadata about a trace (creation time, binary, etc.)
trace_processes	List processes in a trace with PIDs and exec info
session_create	Create a replay session for a specific process. Supports pid (exec'd processes) and fork_pid (forked-without-exec children)
session_list	List all active replay sessions
session_close	End a session and free its resources
run_to_event	Jump to a specific rr event number
interrupt	Stop a running program
breakpoint_set	Set breakpoints by function, file:line, or address. Supports conditional (condition) and temporary breakpoints. Pending breakpoints are enabled automatically for unloaded code
breakpoint_delete	Delete a breakpoint by number
breakpoint_list	List all breakpoints with their state
watchpoint_set	Break on memory writes, reads, or access to an expression
catch	Catchpoints for C++ throw/catch, syscalls (optionally filtered by name), and signals
backtrace	Call stack with optional full mode (includes locals per frame)

How to install the Rr MCP Server

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

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Linux (rr only runs on Linux) - Python 3.11+ - rr installed and in PATH - An rr recording to debug

Example prompts to try

“Use Rr to traces list.”
“Use Rr to trace info.”
“Use Rr to trace processes.”

Frequently asked questions

MCP server for orchestrating multi-process rr debugging sessions Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.