lldb-mcp

lldb-mcp

A Model Context Protocol server for LLDB that provides LLM-driven debugging.

64
Stars
7
Forks
0
Releases

Overview

LLDB-MCP is an MCP server that connects Claude’s Model Context Protocol to the LLDB debugger, enabling AI-driven debugging workflows. It lets Claude start, manage, and interact with LLDB sessions directly, translating natural language prompts into debugging actions. The server supports creating and managing multiple LLDB sessions, loading executables and attaching to running processes, and loading core dump files for post-mortem analysis. Users can issue arbitrary LLDB commands, and have fine-grained control over program execution (run, continue, step, next, finish). It provides memory examination and disassembly, as well as thread and stack frame inspection, to inspect program state. The system includes session management (list, terminate), breakpoint and watchpoint support, and a variety of inspection commands (backtrace, print, examine, etc.). The README also outlines example Claude prompts and a configuration snippet to register the MCP server in the Claude desktop app. Debug tips suggest enabling a debug mode for verbose logs and note that sessions are cleaned up on shutdown. Requirements include Python 3.7+, LLDB installed, and Claude MCP support.

Details

Owner
stass
Language
Python
License
BSD 2-Clause "Simplified" License
Updated
2025-12-07

Features

Create and manage multiple LLDB sessions

Allows users to run and switch between several LLDB debugging sessions concurrently.

Load executables and attach to running processes

Load programs into LLDB or attach to active processes for live debugging.

Load core dump files for post-mortem analysis

Open core dumps to analyze crashes after execution.

Execute arbitrary LLDB commands

Send any LLDB command via the MCP interface when a dedicated function is not available.

Fine-grained control over program execution

Control run, continue, step, next, and finish with precise execution flow.

Memory examination and disassembly

Inspect memory contents and disassemble code to inspect instructions.

Thread and stack frame inspection

List threads, examine frames, and retrieve detailed stack information.

Audience

DevelopersAI-assisted debugging: start, control, and inspect LLDB sessions through Claude MCP using natural language prompts.
LLDB usersInteract with LLDB to load programs, set breakpoints, inspect memory and state, and manage sessions via MCP.

Tags

lldbmcpdebuggingai-assisted debuggingclaudesession-managementbreakpointsmemorydisassemblythreadscore-dumpsexecution-control