lldb-mcp

MCP.Pizza Chef: stass

Twenty-eight tools wrap the LLDB debugger: starting sessions, loading a program or a crash dump, attaching to something already running, setting breakpoints and watchpoints, stepping through execution, and reading memory, registers, variables and the call stack. It runs on macOS and Linux only, needs LLDB already installed, and is copied from source rather than installed from a package. Nothing is sandboxed — it launches real programs and will run any debugger command it is handed. The code has not changed since March 2025.

Unmaintained · No commits in 18 months.
Coding

Use This MCP server To

Find out why my program crashes on certain input Step through a crash one line at a time Read the call stack after something blows up Open a crash dump and see what went wrong Watch a variable and stop when it changes Inspect what is actually sitting in memory

README

LLDB-MCP

Screenshot

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
      }
    }

Usage

Once installed and configured, you can interact with LLDB through Claude using natural language.

lldb-mcp FAQ

Do I need a key or an account?
No. Nothing is sent anywhere. It drives the LLDB debugger already installed on your own machine.
Does it work on Windows?
No. It depends on Unix terminal features, so macOS and Linux only.
Can I use this to investigate a crash I cannot reproduce?
Yes, if you kept the crash dump file. It can load a core dump and show you where the program died.
How hard is the setup?
You download the code, install one Python package and point your app's config file at the script. There is no installer and no published package.
Is anything sandboxed?
No. It starts real programs on your computer and will run any debugger command it is given, including ones that reach the command line.
Is it still maintained?
Nothing has changed since March 2025. The BSD licence makes workplace use fine, but do not expect fixes.
Do I need to be a programmer?
Realistically yes. This is a developer tool, and what comes back is memory addresses, registers and stack frames.