Skip to content

0.1.0

Latest

Choose a tag to compare

@FlorentinoJink FlorentinoJink released this 08 Apr 08:30

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 debugserver targets via host: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, *.crash patterns)

Available Tools

  • open_lldb_core — Analyze core dump files with optional backtrace, threads, and shared libraries
  • open_lldb_remote — Connect to debugserver remote targets
  • launch_debug — Launch programs under LLDB for interactive debugging
  • run_lldb_cmd — Execute custom LLDB commands in any session
  • close_lldb_core — Close core dump sessions
  • close_lldb_remote — Close remote debugging sessions
  • close_debug — Close launch debug sessions and terminate target program
  • list_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 .dSYM symbol 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-allow entitlement or codesign --remove-signature on 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)