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 是你的好幫手）。