AI 코딩 어시스턴트(AI coding assistants)는 소스 코드를 읽는 데는 능숙하지만, 바이너리(binary)를 배포하는 순간 눈이 멀게 됩니다. Claude Code나 Codex에게 컴파일된 .wasm 또는 네이티브 바이너리(native binary)에 대해 물어보면, 파일에 실제로 들어있는 내용이 아니라 소스 수준의 추측을 바탕으로 추론할 것입니다. 우리는 그 간극을 메우기 위해 Hexana MCP 서버를 구축했으며, 오늘 0.3.0 버전을 출시합니다.

Hexana MCP가 하는 일

Hexana MCP 서버는 AI 어시스턴트와 함께 실행되며, 어시스턴트가 컴파일된 결과물(artifacts)인 WASM 모듈과 네이티브 바이너리를 직접 검사할 수 있는 도구들을 제공합니다. 어시스턴트가 바이너리에 무엇이 들어있을지 추측하는 대신, 실제 결과물에 쿼리(query)를 보내 구조화된 답변을 받을 수 있습니다.

이는 다음과 같은 상황에서 중요합니다:

• 소스와 컴파일된 출력물 사이에 차이가 발생한 WASM 모듈 디버깅(Debugging)
• 서드파티(third-party) 바이너리에 의존하기 전에 해당 바이너리가 실제로 무엇을 내보내는지(exports) 이해하기
• 빌드 단계가 의도한 대로 생성되었는지 확인하기
• 해당 바이너리를 링크(link)하는 코드를 작성할 때, AI 에이전트에게 컴파일된 파일에 대한 근거 있고 사실적인 컨텍스트(context) 제공하기

0.3.0의 새로운 기능

주요 추가 사항은 일련의 바이너리 검사 도구들입니다:

• WASM 또는 네이티브 바이너리 요약 (크기, 섹션 분석, 임포트/엑스포트(import/export) 횟수, 포맷 메타데이터)
• 바이너리 레코드 쿼리 (임포트, 엑스포트, 메모리, 글로벌, 테이블 세그먼트, 데이터 세그먼트)
• 이름 또는 인덱스를 통한 모듈 내 함수 목록화 또는 검색

따라서 이제 Claude Code 세션에서 "이 wasm 바이너리를 요약해줘" 또는 "이 모듈에서 gl_와 일치하는 모든 함수를 찾아줘"라고 말하면, 어시스턴트가 파일로부터 실제 데이터를 받아올 수 있습니다.

배포 측면에서는: 0.3.0은 macOS arm64 및 Linux x64에서 GraalVM Native Image로 컴파일된 네이티브 실행 파일(native executables)로 제공됩니다. Claude Code 및 Codex 플러그인 래퍼(wrappers)는 해당 플랫폼에서 번들로 포함된 네이티브 실행 파일을 자동으로 우선 사용하게 되며, 이는 일반적인 상황에서 JVM 콜드 스타트(cold-start)가 없음을 의미합니다 (네이티브 이미지는 즉시 시작되며, 이는 에이전트가 세션 중에 도구를 여러 번 호출할 때 중요합니다). Windows 및 기타 환경을 위한 JVM 폴백(fallback) 기능은 여전히 유지됩니다.

설치 (Claude Code 내부에서 실행, 서버에 플러그인이 포함되어 있어 빌드 단계가 필요 없음):
/plugin marketplace add JetBrains/hexana /plugin install hexana@hexana
macOS arm64 및 Linux x64에서는 번들로 제공되는 네이티브 실행 파일 (native executable)이 자동으로 사용됩니다. Windows 및 기타 플랫폼에서는 JVM 패키지로 폴백 (fallback)되며, 이 경우 PATH에 Java 21 이상의 런타임 (runtime)이 필요합니다. JetBrains 제공, 무료. Codex 사용자: 동일한 플러그인이 Codex 형식으로 0.3.0 릴리스에 포함되어 제공됩니다 ([VERIFY: 정확한 Codex 설치 경로, 이전 게시물에는 없음]).
그 다음 Claude에게 다음과 같이 요청하세요: "Hexana를 사용하여 <path>.wasm의 임포트 (imports), 엑스포트 (exports) 및 메모리 (memories)를 요약해줘."
소스 / 추가 정보
리포지토리 (Repo): https://github.com/JetBrains/hexana
문서 (Docs): https://jetbrains.github.io/hexana
저희는 더 많은 도구들 (콜 그래프 (call graphs), 도미네이터 분석 (dominator analysis), 크기 팽창 분석 (size bloat breakdown))을 개발하기 위해 활발히 작업 중입니다. AI 어시스턴트가 바이너리에 대해 질문할 수 있기를 원하는 특정 기능이 있다면 댓글로 남겨주세요.
제출자: /u/minamoto108
[link] [comments]