How to add LLDB-MCP to Windsurf

Integrate the LLDB debugger with Claude via MCP for AI-assisted debugging sessions. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 105★ · stdio · no auth

Windsurf config for LLDB-MCP

git clone https://github.com/stass/lldb-mcp.git && cd lldb-mcp && pip install mcp

{
  "mcpServers": {
    "lldb-mcp": {
      "command": "python3",
      "args": [
        "/path/to/lldb-mcp/lldb_mcp.py"
      ]
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the LLDB-MCP config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5LLDB-MCP's tools become available to Cascade.

Before you start

Python 3.7+
LLDB installed on the system
Claude desktop app with MCP support
The mcp Python package (pip install mcp)

What LLDB-MCP can do in Windsurf

lldb_start

Start a new LLDB session.

lldb_terminate

Terminate an LLDB session.

lldb_list_sessions

List all active LLDB sessions.

lldb_load

Load a program into LLDB.

lldb_attach

Attach to a running process.

lldb_load_core

Load a core dump file.

lldb_run

Run the loaded program.

lldb_continue

Continue program execution.

Security

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the LLDB-MCP config there under the "mcpServers" key and restart the client.

Is LLDB-MCP safe to use with Windsurf?

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.

View repo Full LLDB-MCP page