맥용 DBJoy 공개, AI로 PostgreSQL 조회·Claude Code 연동

AI로 데이터베이스를 조회하고 SQL을 작성하는 맥용 오픈소스 도구 DBJoy가 공개됐다. 프로젝트 공식 GitHub 문서에 따르면 PostgreSQL 연결, 데이터 편집, 스키마 비교 기능에 자연어 질의와 Claude Code 연동을 결합했다. 12일에는 0.4.4 버전이 배포됐다.

내장 AI 도우미는 테이블 구조를 확인하고 쿼리를 실행한 결과를 대화창에 표시한다. SQL 작성을 요청하면 새 쿼리 탭에 코드를 열어 사용자가 검토하거나 직접 실행할 수 있다. Anthropic 또는 OpenAI API 키를 사용자가 등록하는 방식이며, 키는 macOS 키체인에 저장된다.

내장 AI의 쿼리는 기본적으로 읽기 전용 트랜잭션에서 실행된다. 데이터 변경을 별도로 허용하면 행 추가·수정·삭제와 스키마 변경도 수행할 수 있으며, 변경 전 승인 단계를 거친다. 운영 환경 연결에는 승인 절차가 항상 적용되고, 읽기 전용으로 지정한 연결에는 쓰기를 허용하지 않는다고 공식 문서는 설명한다.

Claude Code나 Cursor 등 외부 AI 도구와의 연결에는 모델 컨텍스트 프로토콜(MCP)을 쓴다. 사용자가 공유 대상으로 선택한 연결의 목록, 테이블과 스키마, 열과 제약조건을 확인하고 읽기 쿼리를 실행하는 기능을 제공한다. 데이터베이스 비밀번호와 SSH 터널은 DBJoy가 관리하므로 프로젝트 파일에 비밀번호를 복사할 필요는 없다.

외부 MCP 연동은 내장 AI의 선택적 쓰기 기능과 달리 읽기 전용이다. 공개된 서버 코드에는 읽기 전용 트랜잭션과 30초 쿼리 제한이 적용돼 있다. 공식 문서상 MCP 서버는 같은 컴퓨터에서만 접속할 수 있는 주소에 열리며, 요청마다 인증 토큰을 요구한다. 연결 공유를 해제하거나 토큰을 초기화해 접근을 중단할 수 있다.

로컬 연결 관리가 AI 질의의 완전한 로컬 처리를 뜻하는 것은 아니다. 공개된 내장 AI 통신 코드에는 쿼리 도구의 결과를 대화 메시지에 넣고 Anthropic 또는 OpenAI API로 보내는 흐름이 포함돼 있다. 데이터베이스 비밀번호를 프로젝트에 복사하지 않는 구조와 조회 결과의 외부 모델 전송은 구분해야 한다.

일반 데이터베이스 작업에는 SQL 편집기, 스키마 간 차이 비교와 마이그레이션 SQL 작성, CSV·JSON 내보내기, pg_dump 백업을 제공한다. SwiftUI 기반으로 개발됐으며 배포 앱은 Apple Silicon과 macOS 15 이상을 지원한다. 라이선스는 MIT다.

이번 0.4.4 릴리스는 실행 중인 앱을 업데이트한 뒤 파일 열기나 내보내기 대화상자가 멈추던 문제를 수정했다. 앱 파일이 교체된 상태에서는 재시작 안내를 표시한다. 릴리스 노트의 수정 내용은 AI 기능의 신규 추가가 아니라 파일 대화상자 동작 개선이다.

출처: DBJoy 공식 GitHub 문서
https://github.com/agustind/dbjoy/blob/v0.4.4/README.md
DBJoy 0.4.4 공식 릴리스
https://github.com/agustind/dbjoy/releases/tag/v0.4.4
DBJoy 공식 MCP 서버 코드
https://github.com/agustind/dbjoy/blob/v0.4.4/Sources/DBJoy/MCP/MCPServer.swift
DBJoy 공식 AI 통신 코드
https://github.com/agustind/dbjoy/blob/v0.4.4/Sources/DBJoy/Assistant/LLMConversation.swift