MCP LLDB v0.1.0 🎉
First release of the Rust implementation of MCP LLDB server for macOS debugging — core dump analysis, remote debugging, and direct program debugging.
🚀 Features
Core Functionality
- Core Dump Analysis: Open and analyze macOS core dump files with backtrace, threads, and shared library info
- Remote Debugging: Connect to
debugservertargets viahost:port - Direct Program Debugging: Launch executables under LLDB, set breakpoints, step through code, inspect variables
- Custom Commands: Execute arbitrary LLDB commands in active sessions
- Session Management: Automatic session pooling, reuse, and dead session eviction
- Crash File Discovery: Search and list core dump and crash report files (supports
core,core.*,*.ips,*.crashpatterns)
Available Tools
open_lldb_core— Analyze core dump files with optional backtrace, threads, and shared librariesopen_lldb_remote— Connect todebugserverremote targetslaunch_debug— Launch programs under LLDB for interactive debuggingrun_lldb_cmd— Execute custom LLDB commands in any sessionclose_lldb_core— Close core dump sessionsclose_lldb_remote— Close remote debugging sessionsclose_debug— Close launch debug sessions and terminate target programlist_crash_files— List available core dumps and crash reports from macOS system paths
Technical Highlights
- ✅ High Performance: Native Rust implementation with Tokio async runtime
- ✅ Memory Safe: Compile-time memory safety guarantees
- ✅ Single Binary: No runtime dependencies
- ✅ MCP Protocol: Full Model Context Protocol support via stdio transport
- ✅ Session Pooling: Automatic LLDB session reuse and dead session eviction
- ✅ Configurable Timeouts: Separate init timeout (symbol loading) and command timeout
- ✅ dSYM Support: Load
.dSYMsymbol bundles for stripped binaries - ✅ Universal Binary: Architecture selection for fat binaries (
arm64/x86_64) - ✅ DevToolsSecurity Detection: Pre-launch checks with clear error messages
- ✅ SIP Awareness: Warns when debugging SIP-protected system paths
- ✅ Hardened Runtime Hints: Suggests
get-task-allowentitlement orcodesign --remove-signatureon permission errors
📦 Installation
Build from Source
git clone https://github.com/FlorentinoJink/mcp-lldb.git
cd mcp-lldb
cargo build --release🔧 Configuration
{
"mcpServers": {
"mcp-lldb": {
"command": "/path/to/mcp-lldb",
"args": []
}
}
}📋 Requirements
- macOS
- LLDB (install via
xcode-select --install)