Lldb MCP

🚀 lldb_mcp

このプロジェクトは、依存関係が少なく、機能が充実したシンプルなlldb mcpサーバーです。コードがシンプルで、必要な機能がすべて備わっています！たった2つのコマンド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を使うのが良いでしょう）。