LLDB MCP 統合

このプロジェクトは、LLDB のための Model-Context Protocol (MCP) 統合を提供し、Claude などの AI アシスタントが標準化されたインターフェースを通じてデバッグセッションと対話できるようにします。

概要

この統合は、次の 2 つの主要コンポーネントで構成されています。

server.py - Claude（または他の MCP クライアント）と通信する MCP サーバー
lldb_plugin.py - LLDB 内部で動作し、JSON-RPC 経由でデバッガ機能を公開するプラグイン

このアーキテクチャにより、Claude が自然言語を通じて LLDB と直接対話することで、コードのデバッグを支援できます。MCP サーバーはブリッジとして機能し、Claude のリクエストを LLDB コマンドに変換し、構造化された形式で結果を返します。

インストール

前提条件

Python 3.10 以上
Python バインディング付き LLDB
fastmcp Python パッケージ（Claude Desktop 統合用）

セットアップ

このリポジトリをクローンします：

git clone https://github.com/ant4g0nist/lldb-mcp.git
cd lldb-mcp

必要な依存関係をインストールします：
```
pip install "fastmcp>=1.2.0" httpx
```
または
```
uv install "fastmcp>=1.2.0" httpx
```

使用方法

方法 1: Claude for Desktop で使用する

Claude for Desktop がインストールされ、最新バージョンに更新されていることを確認してください。
以下のファイルを編集して、Claude for Desktop が LLDB MCP サーバーを使用するように設定します：
- パス: ~/Library/Application Support/Claude/claude_desktop_config.json

パスを更新し、LLDB MCP 設定を追加します：

{
  "mcpServers": {
    "lldb": {
      "command": "/path/to/your/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/your/lldb-mcp/llmcp",
        "run",
        "lldb_mcp.py"
      ]
    }
  }
}

Claude for Desktop を再起動します。
LLDB でデバッグセッションを開始し、次のコマンドで MCP サーバーを有効にします：
```
(lldb) command script import lisa.py
```
Claude for Desktop で LLDB ツールが利用可能になるはずです。ハンマーアイコンを探してください。

方法 2: 直接 LLDB 統合

Claude for Desktop を使用せずに、LLDB から直接プラグインを使用する場合：

プラグインを自動的にロードするには、~/.lldbinit ファイルに以下を追加します：
```
command script import /path/to/lldb_plugin.py
```
LLDB セッションで、MCP サーバーを起動します：
```
(lldb) mcp start
```
サーバーは http://localhost:13338 で利用可能になり、任意の MCP クライアントが接続できます。

利用可能な LLDB ツール

MCP サーバーは、AI アシスタント向けに次のメソッドを公開します：

create_target - 実行可能パスからデバッグターゲットを作成します
launch_process - オプションの引数、環境変数、作業ディレクトリを指定してプロセスを起動します
attach_to_process - PID で実行中のプロセスにアタッチします
detach_from_process - 現在のプロセスからデタッチします
continue_process - プロセス実行を続行します
step_over - 現在の行または命令をステップオーバーします
step_into - 関数呼び出しにステップインします
step_out - 現在の関数からステップアウトします
set_breakpoint - 指定された場所にブレークポイントを設定します
delete_breakpoint - ID でブレークポイントを削除します
list_breakpoints - すべてのブレークポイントを一覧表示します
get_backtrace - 現在のスレッドまたは指定されたスレッドのバックトレースを取得します
get_variables - 現在のフレームの変数を取得します
get_disassembly - 指定されたアドレスまたは現在の PC 周辺の逆アセンブルを取得します
read_memory - 指定されたアドレスからメモリを読み取ります
get_metadata - 現在のデバッグセッションに関するメタデータを取得します
run_lldb_command - 任意の LLDB コマンドを実行します
evaluate_expression - 現在のコンテキストで式を評価します

Claude との対話例

セットアップが完了すると、自然言語を使って Claude 経由で LLDB と対話できます。いくつかの例：

"/path/to/executable でこのプログラムをデバッグして"
"main にブレークポイントを設定して"
"引数 -v input.txt でプログラムを実行して"
"現在のフレームの変数を表示して"
"次の関数呼び出しにステップインして"
"現在のバックトレースは？"
"式 ptr->data[i] を評価して"
"現在の命令のアセンブリコードを表示して"

トラブルシューティング

プラグインが読み込まれない: LLDB の Python 環境が必要なモジュールにアクセスできることを確認してください
サーバー接続の問題: ポート 13338 が他のアプリケーションによって既に使用されていないか確認してください
Claude がツールを検出しない: claude_desktop_config.json の設定が正しいことを確認してください
コマンドエラー: プラグインはエラーを LLDB コンソールに記録します。詳細はそちらを確認してください

貢献

貢献を歓迎します！バグ報告や機能リクエストの issue 作成、プルリクエストの提出を自由に行ってください。

lisa.py

人気