Multi-Debugger MCP Server (LLDB and GDB)

GDB 및 LLDB 디버거 모두에 대한 디버깅 기능을 제공하는 Model Context Protocol 서버로, Claude Desktop, VSCode Copilot 또는 기타 AI 어시스턴트와 함께 사용할 수 있습니다.

빠른 시작

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)

이 프로젝트는 GDB와 함께 실험적인 네이티브 LLDB 지원을 포함하며, 자동 디버거 선택 기능을 제공합니다.

설치

macOS에서 LLDB 지원을 활성화하려면 Homebrew를 통해 LLVM(LLDB 포함)과 python을 설치하세요:

# 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 파일을 참조하세요.