Multi-Debugger MCP Server (LLDB and GDB)

Сервер Model Context Protocol, который предоставляет функции отладки для обоих отладчиков GDB и LLDB, для использования с Claude Desktop, VSCode Copilot или другими ИИ-ассистентами.

Быстрый старт

uv sync
uv venv
uv run server.py

Related MCP server: LLDB MCP Server

Интеграция

Обратите внимание, что вы можете использовать uv run для запуска скрипта server.py или использовать uv venv для создания виртуальной среды, а затем запустить /home/youruser/dev/personal/GDB-MCP/.venv/bin/python /home/youruser/dev/personal/GDB-MCP/server.py.

Claude Desktop

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "gdb": {
      "command": "uv",
      "args": ["run", "/home/youruser/dev/personal/GDB-MCP/server.py"],
      "disabled": false
    }
  }
}

VSCode Copilot

Если вы используете WSL:

 "mcp": {
    "servers": {
      "my-mcp-server-4dc36648": {
        "type": "stdio",
        "command": "wsl",
        "args": [
          "/home/youruser/dev/personal/GDB-MCP/.venv/bin/python",
          "/home/youruser/dev/personal/GDB-MCP/server.py"
        ]
      }
    }
  }

Если вы не используете WSL:

  "mcp": {
    "servers": {
      "my-mcp-server-db89eee1": {
        "type": "stdio",
        "command": "/home/youruser/dev/personal/GDB-MCP/.venv/bin/python",
        "args": ["/home/youruser/dev/personal/GDB-MCP/server.py"]
      }
    }
  }

Windsurf

{
  "mcpServers": {
    "debugger-mcp": {
      "command": "python3",
      "args": ["/Users/youruser/dev/GDB-MCP/server.py"]
    }
  }
}

Экспериментальная поддержка LLDB (macOS)

Этот проект включает экспериментальную нативную поддержку LLDB наряду с GDB, с автоматическим выбором отладчика.

Установка

Чтобы включить поддержку LLDB на macOS, установите LLVM (который включает LLDB) и python через Homebrew:

# Install LLDB for supporting python3.14 bindings
brew install llvm python3

# Install MCP and debugging dependencies
pip3 install mcp pygdbmi --break-system-packages

Доступные инструменты

Унифицированные инструменты

• debugger_status(): Показать доступные отладчики и их статус

• debugger_start(): Запустить сеанс отладки с автоматически определенным отладчиком

• debugger_terminate(session_id): Завершить сеанс отладки

• debugger_list_sessions(): Список всех активных сеансов отладки

• debugger_command(session_id, command): Выполнить команду отладчика

Инструменты LLDB

• lldb_start(): Запустить новый сеанс отладки LLDB

• lldb_terminate(session_id): Завершить сеанс отладки LLDB

• lldb_list_sessions(): Список всех активных сеансов LLDB

• lldb_command(session_id, command): Выполнить произвольную команду LLDB

Инструменты GDB

• gdb_start(gdb_path): Запустить новый сеанс отладки GDB

• gdb_terminate(session_id): Завершить сеанс отладки GDB

• gdb_list_sessions(): Список всех активных сеансов GDB

• gdb_command(session_id, command): Выполнить любую команду GDB

Используйте функции *_command() для всех расширенных операций отладчика, ваш LLM-клиент уже должен знать, как их использовать, но не помешает упомянуть об этом.

Проверка статуса

Вы можете проверить доступность отладчика:

from modules.lldb import LLDBSessionManager
from modules.gdb import GDBSessionManager

print("LLDB available:", LLDBSessionManager.is_available())
print("GDB available:", GDBSessionManager.is_available())

Тестирование

uv run python run-tests.py --check-deps
uv run python run-tests.py --type all

Примеры

Проверьте каталог examples для примеров подсказок.

Примеры бинарных файлов скомпилированы для arm64 и amd64, выберите тот, который соответствует архитектуре вашей системы.

Лицензия

Этот проект лицензирован в соответствии с GNU Version 3.0 License, подробности см. в файле LICENSE.