stass/lldb-mcp

LLDB-MCP

See it in acton here, automatically debugging a buffer overflow: https://x.com/full_duplex/status/1904770477698277847

Overview

LLDB-MCP is a tool that integrates the LLDB debugger with Claude's Model Context Protocol (MCP). This integration allows Claude to start, control, and interact with LLDB debugging sessions directly, enabling AI-assisted debugging workflows.

The tool provides a comprehensive set of commands for working with LLDB, including:

• Starting and managing LLDB sessions
• Loading programs for debugging
• Setting breakpoints and watchpoints
• Controlling program execution
• Examining memory, registers, and variables
• Analyzing stack traces and program state

Features

• Create and manage multiple LLDB debugging sessions
• Load executables and attach to running processes
• Load core dump files for post-mortem analysis
• Execute arbitrary LLDB commands
• Fine-grained control over program execution
• Memory examination and disassembly
• Thread and stack frame inspection

Installation

1. Clone the repository:

   git clone https://github.com/stass/lldb-mcp.git
   cd lldb-mcp
   

2. Install dependencies:

   pip install mcp
   

3. Configure Claude to use the LLDB-MCP server:

   • Open the Claude desktop app configuration
   • Add the following to your MCP configuration:

   "mcpServers": {
     "lldb-mcp": {
       "command": "python3",
       "args": ["/path/to/lldb-mcp/lldb_mcp.py"],
       "disabled": false
     }
   }