DBHub (Universal Database Gateway) — Claude Code MCP 서버

MySQL·PostgreSQL·SQL Server·MariaDB·SQLite·Oracle 등을 단일 인터페이스로 연결하는 범용 DB 게이트웨이 MCP 서버.

DBHub(@bytebase/dbhub)는 Bytebase가 만든 범용 데이터베이스 게이트웨이 MCP 서버입니다. Claude Code 같은 AI 클라이언트가 여러 종류의 관계형 데이터베이스에 같은 방식으로 접근하도록 단일 인터페이스를 제공합니다. 공식 저장소 기준으로 PostgreSQL·MySQL·MariaDB·SQL Server·SQLite를 지원하며, 연결은 표준 DSN(예: postgres://user:password@host:port/dbname) 문자열 하나로 지정합니다(Oracle 등 추가 지원 여부는 버전에 따라 다를 수 있으니 공식 문서 확인 권장).

DBHub가 푸는 문제는 "DB마다 다른 MCP 서버·다른 연결 방식을 따로 붙여야 하는 번거로움"입니다. DB 종류가 바뀌어도 DSN만 교체하면 동일한 도구 세트(SQL 실행, 스키마/테이블/컬럼/인덱스/프로시저 탐색 등)를 그대로 쓸 수 있어, AI가 데이터 구조를 파악하고 쿼리를 작성·실행하는 흐름을 한 곳에서 처리합니다. 트랜잭션을 지원하는 SQL 실행과 함께, 읽기 전용 모드·행 수 제한(row limit)·쿼리 타임아웃 같은 안전장치를 제공해 의도치 않은 대량 변경이나 폭주 쿼리를 막습니다. 또한 stdio·HTTP·SSE 세 가지 전송 모드, SSH 터널링과 SSL/TLS 암호화, 다중 DB 동시 연결, 시각적 점검용 웹 워크벤치 등을 갖추고 있습니다.

여러 데이터베이스(예: 운영 PostgreSQL과 로컬 SQLite, 레거시 MySQL)를 동시에 다루는 개발자, AI에게 스키마를 탐색시키고 분석 쿼리를 맡기려는 데이터 엔지니어, 환경마다 DB 종류가 다른 팀에게 적합합니다. 특정 DB에 깊은 진단·튜닝이 필요하면 전용 서버(Postgres MCP Pro 등)가 더 알맞을 수 있습니다.

언제 쓰나

여러 종류의 관계형 DB(PostgreSQL·MySQL·MariaDB·SQL Server·SQLite)를 하나의 MCP 인터페이스로 묶어 AI에게 스키마 탐색과 쿼리 실행을 맡기고 싶을 때 적합합니다. 환경마다 DB 종류가 달라 DSN만 바꿔 재사용하고 싶거나, AI에게 운영 데이터를 안전하게(읽기 전용·행 제한) 조회시키려는 경우에 유용합니다. 단일 DB에 특화된 깊은 튜닝이 목적이면 전용 서버를 함께 고려하세요.

설치

claude mcp add dbhub -- npx -y @bytebase/dbhub --dsn $DATABASE_DSN  (DSN으로 대상 DB 지정; 정확한 옵션은 공식 repo 참조)

npx로 실행되므로 Node.js 환경이 필요합니다. 대상 DB는 DATABASE_DSN(또는 --dsn) 한 줄로 지정하며, DB 종류별 드라이버 형식(postgres://, mysql://, sqlite:// 등)이 다르니 정확한 DSN·옵션은 공식 저장소를 확인하세요. 읽기 전용 모드·행 제한·쿼리 타임아웃은 옵션으로 켜는 안전장치이며 기본값은 버전에 따라 다를 수 있습니다. HTTP 전송은 기본 0.0.0.0에 바인딩되고 HTTP 클라이언트 인증을 하지 않으므로, 외부 노출 시 127.0.0.1 바인딩 + 리버스 프록시가 권장됩니다.

필요 키(직접 발급, 플레이스홀더): DATABASE_DSN

보안 주의

DATABASE_DSN에는 DB 사용자명·비밀번호·호스트가 그대로 들어가므로 최고 등급 비밀로 취급하세요(커밋·로그·출력 금지, 환경변수/시크릿 매니저 사용). AI가 임의 SQL을 실행할 수 있어, 운영 DB 연결 시 반드시 읽기 전용 모드를 켜고 최소 권한 계정을 별도로 발급하는 것을 권장합니다(쓰기 권한 계정 연결 시 INSERT/UPDATE/DELETE·DROP 등 파괴적 작업이나 대량 변경 위험). DB에 저장된 텍스트(레코드 값·코멘트)에 악의적 지시가 섞여 프롬프트 인젝션으로 이어질 수 있으니, 조회 결과를 신뢰된 명령으로 그대로 따르지 않도록 주의하세요. HTTP 전송은 인증이 없으므로 외부에 노출하지 말고 로컬 바인딩+프록시로 보호하세요.

자주 묻는 질문

DBHub는 어떤 데이터베이스를 지원하나요?

공식 저장소 기준 PostgreSQL·MySQL·MariaDB·SQL Server·SQLite를 지원하며, 표준 DSN 문자열로 연결합니다. 그 외 DB(예: Oracle) 지원 여부는 버전에 따라 다를 수 있으니 공식 문서를 확인하세요.

AI가 실수로 데이터를 바꾸지 않게 하려면?

읽기 전용 모드를 켜고, 행 수 제한·쿼리 타임아웃 같은 안전장치를 활용하세요. 추가로 DB 측에서 SELECT만 가능한 최소 권한 계정을 따로 발급해 DSN에 연결하는 것이 안전합니다.

여러 DB를 동시에 연결할 수 있나요?

네, 다중 DB 동시 연결을 지원합니다. 또한 stdio·HTTP·SSE 전송 모드와 SSH 터널링·SSL/TLS를 제공합니다. 자세한 설정은 공식 저장소를 참고하세요.