테이블 정의서와 ER 다이어그램을 자동 생성해 AI가 테이블 구조에 답하게 하는 도구를 만들어 봤다

무슨 일이 있었나요?

글쓴이는 회사에서 잘 모르는 하위 시스템의 표(테이블) 구조를 빨리 익히려고 'dbxray'를 만들었습니다. 이 도구는 데이터베이스에 접속해 표 정의서, 표 목록, ER도를 Markdown 문서로 뽑아냅니다. 또 그 결과를 AI가 읽을 수 있게 하는 MCP 서버도 함께 제공합니다. MCP 서버를 연결한 Claude Code에 '직원 관련 표를 찾아줘'나 '어떻게 JOIN하면 되지?' 같은 질문을 할 수 있습니다.

핵심 정보

• 최신 버전은 v0.4.2입니다.
• 지원 데이터베이스는 PostgreSQL(13 이상 권장)과 Oracle(12c 이상 권장)입니다.
• Java 21에서 동작하며, 배포 zip에 Java가 들어 있어 따로 설치할 필요가 없습니다.
• 비밀번호는 설정 파일 대신 환경 변수 DBXRAY_DB_PASSWORD로 넘깁니다.

알아두면 좋은 배경

표 정의서는 표의 열(컬럼), 인덱스, 제약 조건, 외래 키 등을 적은 문서입니다. ER도는 표들 사이의 연결 관계를 그림으로 나타낸 것입니다. 큰 시스템에서는 이런 문서가 없거나 오래된 경우가 많습니다. 이 도구는 DB에서 직접 정보를 읽어 이 문제를 줄이려고 합니다.

왜 중요한가요?

문서가 부족한 큰 시스템에서도 사람과 AI가 표 구조를 빨리 파악할 수 있습니다. 예를 들어 어떤 표를 바꾸면 어디에 영향이 가는지, 두 표를 어떻게 연결하면 되는지를 AI에게 물어볼 수 있습니다. AI로 코드를 쓸 때 표 구조를 함께 참고하게 한다는 점에서 실용성이 높습니다.

앞으로 볼 점

• 글에서 소개한 기능(외래 키 대신 정보를 직접 적기, ER도 나누기, 업무 단위 묶기, 문서 누락 감지)이 실제로 잘 동작하는지
• MCP 서버를 통해 AI가 찾는 표와 연결 방식이 정확한지
• 저장소 ebichan88/dbxray의 업데이트 상황