sudo apt update
sudo apt install -y gdb-multiarch gcc-arm-none-eabi

brew install gdb arm-none-eabi-gdb

cd sungdb-mcp
./install.sh

cd sungdb-mcp

# 가상환경 생성
python3 -m venv venv
source venv/bin/activate

# 의존성 설치
pip install --upgrade pip
pip install -r requirements.txt

# 패키지 설치
pip install -e .

# 가상환경 활성화
source venv/bin/activate

# 서버 실행
python sungdb_mcp.py
# 또는
sungdb-mcp

{
  "mcpServers": {
    "sungdb": {
      "command": "python",
      "args": ["/path/to/cortex-m-hello-world/sungdb-mcp/sungdb_mcp.py"],
      "env": {}
    }
  }
}

{
  "mcpServers": {
    "sungdb": {
      "command": "/path/to/cortex-m-hello-world/sungdb-mcp/venv/bin/python",
      "args": ["/path/to/cortex-m-hello-world/sungdb-mcp/sungdb_mcp.py"],
      "env": {}
    }
  }
}

{
  "mcp": {
    "mcpServers": {
      "sungdb": {
        "command": "/path/to/cortex-m-hello-world/sungdb-mcp/venv/bin/python",
        "args": ["/path/to/cortex-m-hello-world/sungdb-mcp/sungdb_mcp.py"],
        "env": {}
      }
    }
  }
}

{
  "mcp": {
    "mcpServers": {
      "sungdb": {
        "command": "python3",
        "args": ["/path/to/cortex-m-hello-world/sungdb-mcp/sungdb_mcp.py"],
        "env": {
          "PYTHONPATH": "/path/to/cortex-m-hello-world/sungdb-mcp/venv/lib/python3.11/site-packages"
        }
      }
    }
  }
}

{
  "mcp": {
    "mcpServers": {
      "sungdb": {
        "command": "C:\\path\\to\\cortex-m-hello-world\\sungdb-mcp\\venv\\Scripts\\python.exe",
        "args": ["C:\\path\\to\\cortex-m-hello-world\\sungdb-mcp\\sungdb_mcp.py"],
        "env": {}
      }
    }
  }
}

{
  "mcpServers": {
    "sungdb": {
      "command": "/path/to/cortex-m-hello-world/sungdb-mcp/venv/bin/python",
      "args": ["/path/to/cortex-m-hello-world/sungdb-mcp/sungdb_mcp.py"],
      "env": {}
    }
  }
}

# 1. GDB 세션 시작
session = await gdb_start(gdb_path="arm-none-eabi-gdb")

# 2. 프로그램 로드
await gdb_load(session_id, "build/cortex-m33-hello-world.elf")

# 3. 브레이크포인트 설정
await gdb_set_breakpoint(session_id, "main")

# 4. 프로그램 실행 시작
await gdb_continue(session_id)

# 5. 변수 값 확인
await gdb_print(session_id, "variable_name")

# 6. 스텝 실행
await gdb_step(session_id)

# 7. 호출 스택 확인
await gdb_backtrace(session_id)

# 8. 세션 종료
await gdb_terminate(session_id)

# ARM Cortex-M 디버깅용 GDB 세션 시작
session = await gdb_start(
    gdb_path="gdb-multiarch", 
    working_dir="/path/to/cortex-m-hello-world"
)

# ELF 파일 로드
await gdb_load(session_id, "build/cortex-m33-hello-world.elf")

# ARM 아키텍처 설정 (Cortex-M33용)
await gdb_command(session_id, "set architecture armv8-m.main")

# Boot Handler 디스어셈블리 확인
await gdb_command(session_id, "disassemble/r 0x10000008")

# main 함수 디스어셈블리 확인
await gdb_command(session_id, "disassemble/r main")

# QEMU에 연결 (원격 디버깅)
await gdb_command(session_id, "target remote localhost:1234")

# 메인 함수에 브레이크포인트 설정
await gdb_set_breakpoint(session_id, "main")

# 실행 시작
await gdb_continue(session_id)

# ARM 레지스터 확인
await gdb_info_registers(session_id)

# 메모리 검사 (스택 포인터 주변)
await gdb_examine(session_id, "$sp", count=8, format="x")

0x10000008 <+0>: 4800    ldr    r0, [pc, #0]    @ (0x1000000c <Reset_Handler+4>)
0x1000000a <+2>: 4700    bx     r0
0x1000000c <+4>: 0045    lsls   r5, r0, #1
0x1000000e <+6>: 1000    asrs   r0, r0, #32

0x10000044 <+0>:  b570    push   {r4, r5, r6, lr}
0x10000046 <+2>:  2204    movs   r2, #4
0x10000048 <+4>:  b082    sub    sp, #8
0x1000004a <+6>:  4b21    ldr    r3, [pc, #132]  @ (0x100000d0 <main+140>)
0x1000004c <+8>:  4610    mov    r0, r2
0x1000004e <+10>: 4619    mov    r1, r3
0x10000050 <+12>: beab    bkpt   0x00ab  ; Semihosting call
0x10000052 <+14>: 4604    mov    r4, r0
...
0x100000cc <+136>: f7ff ffb0  bl     0x10000030 <exit_program>

✅ 함수 주소 정확히 식별:
- main: 0x10000044
- print_string: 0x10000020  
- exit_program: 0x10000030

✅ 메모리 섹션 올바르게 매핑:
- 0x10000000 - 0x10000010: .text (boot)
- 0x10000010 - 0x10000020: .text.semihost
- 0x10000020 - 0x10000030: .text.print
- 0x10000030 - 0x10000044: .text.exit
- 0x10000044 - 0x100000f0: .text.main

✅ 문자열 상수 정확히 추적:
- 0x100000f0: '=' 반복 문자열
- 0x10000118: "Hello World from Fixed Project!\n"

✅ 스택 구조 정확히 확인:
- __StackTop: 0x10080000 (RAM 최상위)
- 하향 성장 (Full Descending Stack) 확인
- ARM AAPCS 표준 준수

LLM Request → FastMCP → SungDBMCP → GDBSession → Command Queue → GDB Process
                ↑                                                        ↓
          JSON Response ← Result Future ← Background Task ← GDB Output

cd sungdb-mcp
source venv/bin/activate
python -m pytest tests/ -v

# 서버 실행
python sungdb_mcp.py

# 다른 터미널에서 테스트 스크립트 실행
python test_manual.py

# sungdb_mcp.py에서 _setup_tools 메소드에 추가
self.mcp.add_tool("my_new_tool", "새로운 도구 설명")(self.my_new_tool)

# 새로운 메소드 구현
async def my_new_tool(self, session_id: str, param: str) -> Dict[str, Any]:
    if session_id not in self.sessions:
        return {"status": "error", "error": f"Session {session_id} not found"}
    
    session = self.sessions[session_id]
    return await session.execute_command(f"my_gdb_command {param}")

import logging
logging.getLogger("sungdb_mcp").setLevel(logging.DEBUG)

pip install pexpect

# ARM 크로스 컴파일러 설치
sudo apt install gcc-arm-none-eabi gdb-multiarch

# 또는 gdb_path 파라미터로 경로 지정
await gdb_start(gdb_path="/usr/bin/gdb-multiarch")

# 의존성 재설치
pip install --upgrade fastmcp

# 포트 충돌 확인
netstat -tlnp | grep :포트번호

# 디버그 모드로 서버 실행
PYTHONPATH=. python -m logging --level=DEBUG sungdb_mcp.py

# 세션 상태 모니터링
sessions_info = await gdb_list_sessions()
print(f"활성 세션 수: {sessions_info['count']}")

✅ ARM Thumb 명령어 정확 분석:
- main: push {r3, r4, r5, r6, r7, lr}
- 함수 호출: bl 0x10000040 <print_hello_world>
- 21개 C 함수 완벽 컴파일 확인

✅ 초기화된 전역변수 정확 저장:
- task2_context 구조체 값 100% 일치
- FLASH→RAM 복사 과정 정상 동작

✅ 0 초기화 완벽 확인:
- 1,292 bytes 모두 0x00으로 정확 초기화
- Reset_Handler 동작 검증 완료

✅ 동적 메모리 관리 검증:
- HEAP: 0x3000059c~0x300015a0 (4,100 bytes)
- STACK: 0x300015a0~0x300035a0 (8,192 bytes)
- ARM AAPCS 표준 완벽 준수