
LLDB-MCP
Integrate the LLDB debugger with Claude via MCP for AI-assisted debugging sessions.
Add to your client
Copy the config for your MCP client and paste it into its config file.
git clone https://github.com/stass/lldb-mcp.git && cd lldb-mcp && pip install mcpPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"lldb-mcp": {
"command": "python3",
"args": [
"/path/to/lldb-mcp/lldb_mcp.py"
]
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- Python 3.7+
- LLDB installed on the system
- Claude desktop app with MCP support
- The mcp Python package (pip install mcp)
About LLDB-MCP
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. It provides commands for managing sessions, loading programs, setting breakpoints and watchpoints, controlling execution, and examining memory, registers, variables, and stack traces.
Tools & capabilities (28)
lldb_startStart a new LLDB session.
lldb_terminateTerminate an LLDB session.
lldb_list_sessionsList all active LLDB sessions.
lldb_loadLoad a program into LLDB.
lldb_attachAttach to a running process.
lldb_load_coreLoad a core dump file.
lldb_runRun the loaded program.
lldb_continueContinue program execution.
lldb_stepStep to next line or instruction.
lldb_nextStep over function calls.
lldb_finishExecute until the current function returns.
lldb_killKill the running process.
lldb_set_breakpointSet a breakpoint.
lldb_breakpoint_listList all breakpoints.
lldb_breakpoint_deleteDelete a breakpoint.
lldb_watchpointSet a watchpoint on a variable or memory address.
lldb_backtraceShow call stack.
lldb_printPrint value of expression.
lldb_examineExamine memory.
lldb_info_registersDisplay registers.
lldb_frame_infoGet detailed information about a stack frame.
lldb_disassembleDisassemble code.
lldb_process_infoGet information about the current process.
lldb_thread_listList all threads in the current process.
lldb_thread_selectSelect a specific thread.
lldb_commandExecute an arbitrary LLDB command.
lldb_expressionEvaluate an expression in the current frame.
lldb_helpGet help for LLDB commands.
When to use it
- AI-assisted debugging of crashing programs (e.g. automatically diagnosing a buffer overflow)
- Post-mortem analysis of core dump files
- Inspecting memory, registers, and stack frames during a debugging session
- Attaching to and controlling running processes through natural language
Security notes
The server can attach to running processes and execute arbitrary LLDB commands on the host. Check for permission issues when attaching to processes. Enable debug mode with the --debug flag for detailed logging.
LLDB-MCP FAQ
How do I run LLDB commands that don't have a dedicated function?
Use the lldb_command tool to execute arbitrary LLDB commands directly.
How do I enable detailed logging?
Start the server with the --debug flag to enable debug mode for detailed logging.
What should I do if LLDB commands are timing out?
Check that LLDB is installed correctly and verify the path to LLDB when starting a new session.
Alternatives to LLDB-MCP
Compare all alternatives →Microsoft's official browser-automation MCP using Playwright's accessibility tree (no vision model).
Up-to-date, version-specific library documentation injected into your coding agent.
LSP-powered coding agent toolkit: semantic symbol search, references and structural edits.
Compare LLDB-MCP with: