Lldb MCP

🚀 lldb_mcp

lldb_mcp 是一个功能完善且依赖极少的简单 lldb mcp 服务器，代码简洁却功能齐全。它仅包含 lldb_init 和 lldb 两个命令，不会让你的工具集变得杂乱。该服务器与 o4 - mini 和 Gemini 2.5 Pro 配合使用时，能发挥出出色的效果，并且你可以始终对流程保持完全的控制。此外，它还能自动捕获输出，无需手动复制粘贴。

🚀 快速开始

lldb_mcp 是一个功能强大且易于使用的工具，以下为你详细介绍其使用方法。

📦 安装指南

克隆仓库

git clone https://github.com/stableversion/lldb_mcp

创建虚拟环境并安装依赖

cd lldb_mcp && python3 -m venv venv && source venv/bin/activate && pip3 install fastmcp

配置文件示例

{
  "mcpServers": {
    "lldb": {
      "command": "/path/to/lldb_mcp/venv/bin/python",
      "args": ["/path/to/lldb_mcp/lldb_mcp.py"]
    }
  }
}

在 LLDB 中导入命令脚本

(lldb) command script import /path/to/lldb_mcp/lldb_server.py

🔧 技术细节

系统架构

整个代码库不到 200 行，其设计精妙，主要基于以下几个方面：

• 同步调试器：通过调用 debugger.SetAsync(False)，让 HandleCommand 阻塞并直接捕获所有输出，避免了使用复杂的事件监听器（SBListener）和轮询机制。
• 简单控制器：LLDBController 通过 HandleCommand 执行命令，并返回接收到的完整输出或错误信息。
• 标准库：使用 Python 的内置 socketserver 和 json 库，简化了代码结构。

安全考量

由于 lldb 可以执行任意命令，因此需要进行严格限制：

• 你必须手动在 lldb 会话中启动服务器。
• 某些命令被列入黑名单，具体可检查 lldb_server.py 文件。
• 不允许进行命令链式调用（o4 - mini 特别喜欢这样做）。

⚠️ 注意事项

⚠️ 重要提示

• o4 mini 在内存命令中容易出现 --address 幻觉。
• 一些命令在没有输出的情况下“成功”，这会让 llm 感到困惑，因此会返回“执行成功”。
• “继续”可能会无限运行直到遇到断点，这意味着 mcp 可能会无限等待输出（使用 skip 和 continue 是你的好帮手）。