接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
LLDB MCP Server is a debugging server based on the Model Context Protocol (MCP). It exposes LLDB debugging capabilities to AI assistants like Claude Code and Claude Desktop through 40 specialized tools, enabling AI-driven interactive debugging of C/C++ applications.
Core Architecture: Multi-session design where each debugging session has isolated SBDebugger, SBTarget, and SBProcess instances, supporting concurrent debugging workflows.
Use Cases:
Key Capabilities:
macOS:
Linux:
sudo apt install lldb-18 python3-lldb-18 (Ubuntu) or equivalentWindows:
choco install -y llvm python# Install Homebrew LLVM (includes LLDB)
brew install llvm
# Install uv (provides uvx command)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Add Homebrew LLVM to PATH (add to ~/.zshrc)
export PATH="$(brew --prefix llvm)/bin:$PATH"
# Reload shell configuration
source ~/.zshrc
hash -r
# Verify LLDB installation
which lldb
lldb --version
# Install LLDB with Python bindings
sudo apt update
sudo apt install lldb-19 python3-lldb-19
# Install uv (provides uvx command)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Find LLDB Python path
lldb-19 -P
# Example output: /usr/lib/llvm-19/lib/python3.12/site-packages
# Verify Python 3.12 is available (required for LLDB-19 bindings)
which python3.12
python3.12 --version
# Test LLDB Python bindings
python3.12 -c "import sys; sys.path.insert(0, '$(/usr/bin/lldb-19 -P)'); import lldb; print('LLDB Python bindings OK')"
⚠️ CRITICAL - Linux Python Version Matching:
- LLDB Python bindings are compiled for a specific Python version (e.g., LLDB-19 → Python 3.12)
uvxdefaults to the system's default Python (often 3.14 from linuxbrew)- You MUST force uvx to use the matching Python version with
--python /usr/bin/python3.12- Always set
LLDB_PYTHON_PATHto the output oflldb-19 -P- Mismatch between Python versions causes
cannot import name '_lldb'error
For other Linux distributions (Fedora, Arch, etc.), see the Linux Installation Guide.
# Install LLVM (includes LLDB) and Python
choco install -y llvm python
# Verify LLDB and Python
lldb --version
python --version
# Verify LLDB Python bindings
python -c "import lldb; print('LLDB Python bindings OK')"
# Install lldb-mcp-server
pip install -U lldb-mcp-server
lldb-mcp-server --help
If import lldb fails, see the Windows Installation Guide for how to set LLDB_PYTHON_PATH.
Choose your IDE and follow the configuration instructions:
macOS - Global Configuration (Recommended):
Intel (x86_64):
claude mcp add-json --scope user lldb-debugger '{
"type": "stdio",
"command": "uvx",
"args": ["--python", "/usr/local/opt/[email protected]/bin/python3.13", "lldb-mcp-server"],
"env": {
"LLDB_MCP_ALLOW_LAUNCH": "1",
"LLDB_MCP_ALLOW_ATTACH": "1",
"PYTHONPATH": "/usr/local/opt/llvm/lib/python3.13/site-packages"
}
}'
Apple Silicon (arm64):
claude mcp add-json --scope user lldb-debugger '{
"type": "stdio",
"command": "uvx",
"args": ["--python", "/opt/homebrew/opt/[email protected]/bin/python3.13", "lldb-mcp-server"],
"env": {
"LLDB_MCP_ALLOW_LAUNCH": "1",
"LLDB_MCP_ALLOW_ATTACH": "1",
"PYTHONPATH": "/opt/homebrew/opt/llvm/lib/python3.13/site-packages"
}
}'
Linux:
# First, get your LLDB Python path
LLDB_PATH=$(/usr/bin/lldb-19 -P)
echo "LLDB Python path: $LLDB_PATH"
# Then add MCP server configuration
claude mcp add-json --scope user lldb-debugger '{
"type": "stdio",
"command": "uvx",
"args": ["--python", "/usr/bin/python3.12", "-q", "lldb-mcp-server", "--transport", "stdio"],
"env": {
"LLDB_MCP_ALLOW_LAUNCH": "1",
"LLDB_MCP_ALLOW_ATTACH": "1",
"LLDB_PYTHON_PATH": "'"$LLDB_PATH"'"
}
}'
Important Notes:
- Replace
/usr/bin/python3.12with your system's Python 3.12 path if different- The
--pythonargument must match the Python version LLDB was compiled for- Check LLDB's Python version:
lldb-19 -P | grep python3.- If you have LLDB-18, use
lldb-18 -Pand adjust Python version accordingly
macOS:
Edit ~/Library/Application Support/Claude/claude_desktop_config.json
Linux:
Edit ~/.config/claude/claude_desktop_config.json
See Configuration Guide for detailed configuration examples.
Create .cursor/mcp.json in your project root or ~/.cursor/mcp.json for global configuration.
See Configuration Guide for platform-specific examples.
Use codex mcp add command or edit ~/.codex/config.toml.
See Configuration Guide for detailed instructions.
All Platforms:
No manual installation required! When you configure the MCP server using uvx, it automatically installs and manages the package.
Just configure your IDE and start Claude Code or restart Claude Desktop.
User: "Debug the program at /path/to/my/app"
Claude automatically:
1. Creates a debugging session
2. Loads the binary
3. Sets breakpoints
4. Launches the process
5. Analyzes execution
User: "This program crashed, help me analyze the cause"
Claude will:
1. Analyze the crash event
2. Show crash stack trace
3. Check register state
4. Detect dangerous functions
5. Provide repair suggestions
For more examples, see the Usage Guide.
No module named lldb# Verify LLDB is from Homebrew
which lldb
# Add to PATH
echo 'export PATH="$(brew --prefix llvm)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
hash -r
cannot import name '_lldb'This error occurs when uvx uses a different Python version than LLDB was compiled for.
# Check LLDB's Python version
lldb-19 -P
# Example: /usr/lib/llvm-19/lib/python3.12/site-packages (Python 3.12)
# Check uvx's default Python
uvx --python-preference system python --version
# If this shows 3.14, but LLDB needs 3.12, that's the problem
# Solution: Force uvx to use matching Python version
# Update your MCP config to include: "--python", "/usr/bin/python3.12"
# See Linux configuration section above for complete example
For more issues and solutions, see the Troubleshooting Guide.
This project is licensed under the MIT License - see the LICENSE file for details.
AI-powered C/C++ debugger via LLDB and Model Context Protocol. 40 debugging tools for Claude Code and Claude Desktop.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Lldb 透過 stdio 在本機執行。
上次檢查時間:2026-10-28。 AI-powered C/C++ debugger via LLDB and Model Context Protocol. 40 debugging tools for Claude Code and Claude Desktop.