Интеграция LLDB MCP

Этот проект предоставляет интеграцию с протоколом модель-контекст (MCP) для LLDB, позволяя AI-ассистентам, таким как Claude, взаимодействовать с вашими сеансами отладки через стандартизированный интерфейс.

Обзор

Интеграция состоит из двух основных компонентов:

server.py — MCP-сервер, который общается с Claude (или другими MCP-клиентами)
lldb_plugin.py — плагин, работающий внутри LLDB и предоставляющий функциональность отладчика через JSON-RPC

Такая архитектура позволяет Claude помогать вам с отладкой кода, напрямую взаимодействуя с LLDB через естественный язык. MCP-сервер выступает в роли моста, преобразуя запросы Claude в команды LLDB и возвращая результаты в структурированном формате.

Установка

Предварительные требования

Python 3.10 или выше
LLDB с Python-привязками
Пакет Python fastmcp (для интеграции с 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

Если вы предпочитаете использовать плагин напрямую из LLDB без Claude for Desktop:

Добавьте следующую строку в файл ~/.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 — Получить backtrace для текущего или указанного потока
get_variables — Получить переменные в текущем фрейме
get_disassembly — Получить дизассемблирование вокруг указанного адреса или текущего PC
read_memory — Читать память по указанному адресу
get_metadata — Получить метаданные о текущем сеансе отладки
run_lldb_command — Выполнить произвольную команду LLDB
evaluate_expression — Вычислить выражение в текущем контексте

Примеры взаимодействия с Claude

После настройки вы можете взаимодействовать с LLDB через Claude на естественном языке. Примеры:

"Отладь эту программу по пути /path/to/executable"
"Установи точку останова на main"
"Запусти программу с аргументами -v input.txt"
"Покажи переменные в текущем фрейме"
"Шагни внутрь следующего вызова функции"
"Какой сейчас backtrace?"
"Вычисли выражение ptr->data[i]"
"Покажи ассемблерный код на текущей инструкции"

Устранение неполадок

Плагин не загружается: Убедитесь, что окружение Python LLDB имеет доступ к необходимым модулям.
Проблемы с подключением к серверу: Проверьте, не занят ли порт 13338 другим приложением.
Claude не определяет инструменты: Проверьте правильность конфигурации в claude_desktop_config.json.
Ошибки команд: Плагин записывает ошибки в консоль LLDB; проверьте её для подробностей.

Вклад в проект

Вклад приветствуется! Не стесняйтесь отправлять pull request'ы или создавать issue'ы для сообщений об ошибках и запросов функций.

lisa.py

Популярное