DBHub의 개요
데이터베이스 도구 회사 Bytebase의 DBHub는 서버 하나로 MCP 클라이언트를 PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite에 연결합니다. TOML 파일 하나에 여러 연결을 한꺼번에 정의할 수 있으며, SSH 터널링, SSL/TLS 클라이언트 인증서, AWS RDS IAM 인증을 지원합니다. 저장소의 GitHub 스타는 약 3,700개입니다. 버전 1.5.0은 2026년 10월 9일에 나왔고, npm 패키지는 10월 18일까지 한 달 동안 약 166,000회 다운로드되었습니다.
기본으로 불러오는 도구는 execute_sql과 search_objects의 2개이며, README는 이를 컨텍스트 1.4k 토큰으로 봅니다. explain_sql과 health_check는 선택해서 켜며, 설정 파일에 파라미터를 받는 자체 SQL 도구를 정의할 수도 있습니다. HTTP 전송에서는 MCP 클라이언트 없이 쿼리를 실행하고 요청 트레이스를 볼 수 있는 웹 워크벤치도 제공합니다.
npx @bytebase/dbhub@latest와 데이터베이스 연결 문자열(DSN)로 실행합니다. Docker, MCP Bundle, Claude Code 플러그인도 제공됩니다. Claude Code의 공식 문서는 PostgreSQL 연결 예시로 이 서버를 씁니다.
DBHub 설치 방법
npx @bytebase/dbhub@latest --dsn "postgres://user:password@localhost:5432/dbname"DBHub, 쓸 만한 가치가 있습니까?
DBHub의 매력은 절제입니다. 기본 도구 2개와 점진적인 스키마 탐색 덕분에 컨텍스트 사용량이 적습니다. README는 기본 부담을 1.4k 토큰으로, Google의 MCP Toolbox와 Supabase 서버는 약 19k로 봅니다. Bytebase가 직접 한 비교이지만 설계를 보면 믿을 만합니다. 프로세스 하나로 SSH 터널, 클라이언트 인증서, RDS IAM 인증과 함께 6개의 데이터베이스 엔진을 다룬다는 점도 장점입니다.
안전장치는 설정이 필요하고, 고쳐야 했던 적도 있습니다. 읽기 전용 모드는 TOML 파일에서 도구마다 켜야 합니다. 2026년 6월에 높은 심각도의 보안 권고 3건이 공개되었습니다. MySQL과 MariaDB에서 주석 파싱 불일치를 통해 읽기 전용을 우회할 수 있었고(CVE-2026-61789), PostgreSQL의 읽기 전용 트랜잭션이 실제로는 켜지지 않아 키워드 검사만 남아 있었으며(CVE-2026-61788), HTTP 전송이 악성 웹 페이지의 DNS 리바인딩에 노출되어 있었습니다(CVE-2026-61742). 모두 0.22.6에서 고쳐졌고, 1.5.0은 읽기 전용 모드에서 set_config()를 막는 조치를 추가했습니다. 수정 자체는 안심이 되지만, 이런 반복은 도구의 검사에만 기대지 말아야 할 이유입니다.
문서도 그렇게 말합니다. 권한이 큰 PostgreSQL 역할은 읽기 전용 트랜잭션 안에서도 pg_read_file, lo_export, COPY ... TO PROGRAM으로 서버 파일을 읽거나 쓰고 명령을 실행할 수 있으며, MySQL에서 DDL을 막는 것은 분류기뿐입니다. Bytebase는 최소 권한의 읽기 전용 사용자로 연결하라고 권하며, 이는 규칙으로 받아들여야 합니다. HTTP 모드도 같은 주의가 필요합니다. 기본으로 0.0.0.0에 바인딩하고, --auth-token을 설정하지 않으면 토큰을 요구하지 않습니다.
빠진 기능은 의도된 것입니다. 승인 흐름, 데이터 마스킹, 감사 로그가 없으며, 이는 Bytebase가 주력 제품에서 판매하는 기능입니다. 팀은 Claude Code 같은 호스트가 이미 파괴적으로 표시된 도구를 통제한다는 이유로 서버에 쓰기 확인을 넣지 않기로 했습니다. Supabase나 Neon의 업체 서버는 브랜치나 프로젝트 같은 플랫폼 자체도 관리하지만, DBHub는 그런 일을 시도하지 않습니다.
제 역할을 하는 곳
Postgres와 SQL Server를 함께 운영하는 팀의 백엔드 개발자
Claude Code나 Cursor에서 낯선 스키마를 살펴보고 쿼리 초안을 쓰기
dbhub.toml 하나에 두 소스를 정의합니다. search_objects가 테이블과 인덱스를 단계적으로 훑고, execute_sql은 max_rows를 1,000으로 둔 채 초안을 실행합니다. 무료이고 MIT 라이선스이며, 드는 일은 데이터베이스마다 읽기 전용 역할을 만드는 것뿐입니다.
SQL 배경이 없는 운영 분석가
Claude Desktop에서 보고용 데이터베이스로 질문에 답하기
읽기 전용 MCP Bundle을 설치하거나, 모델이 SQL을 쓰는 대신 이름 있는 쿼리를 호출하도록 TOML에 파라미터를 받는 맞춤 도구를 정의합니다. 그러면 잘못될 수 있는 범위가 그 도구들이 닿는 뷰로 좁혀집니다.
느린 프로덕션 MySQL 복제본을 조사하는 SRE
쓰기 위험 없이 쿼리 계획과 연결 상태를 확인하기
explain_sql과 health_check를 켜고, readonly = true와 query_timeout을 설정한 뒤, MySQL 읽기 전용 우회를 막은 릴리스인 0.22.6 이상에서 SELECT 전용 사용자로 연결합니다.
도입 전 확인할 점
- 설정
- 아무 MCP 클라이언트에 npx @bytebase/dbhub@latest --transport stdio --dsn "postgres://..."를 추가하거나, Docker, MCP Bundle, Claude Code 플러그인을 씁니다. Node 22.5 이상이 필요합니다. 첫 쿼리까지 몇 분이면 되며, 여러 데이터베이스에는 dbhub.toml이 필요합니다.
- 연동
- 기본 도구 2개(execute_sql, search_objects), 선택 도구 2개(explain_sql, health_check), 그리고 TOML로 정의하는 맞춤 SQL 도구가 있습니다. HTTP 전송은 웹 워크벤치, /healthz 엔드포인트, 로드 밸런서 뒤에서의 무상태 서비스를 더합니다.
- 데이터와 개인정보
- DSN의 데이터베이스 사용자가 할 수 있는 일은 무엇이든 할 수 있으며, readonly = true가 아니면 DDL도 포함됩니다. 모든 것이 사용자의 컴퓨터에서 실행되고, 결과는 클라이언트가 쓰는 모델로 갑니다. 공유 네트워크에서는 HTTP 모드에 --auth-token과 --host 127.0.0.1이 필요합니다.
- 대규모 사용 시 비용
- 무료이며, 실제 비용은 데이터베이스 부하입니다. 도구별 max_rows와 query_timeout이 폭주하는 에이전트 쿼리를 막고, 무상태 HTTP 전송으로 여러 복제본이 트래픽을 나눌 수 있습니다.
- 제한
- 승인, 마스킹, 감사 로그가 없고, 브랜칭 같은 플랫폼 관리도 없습니다. MySQL과 MariaDB의 읽기 전용 모드에서 DDL을 막는 것은 키워드 분류기뿐입니다.
좋은 점
- 서버 하나로 6개의 데이터베이스 엔진을 다룹니다
- 기본 도구 2개로 컨텍스트는 약 1.4k 토큰입니다
- 읽기 전용을 키워드 검사와 데이터베이스 트랜잭션으로 강제합니다
- SSH 터널, SSL 클라이언트 인증서, RDS IAM 인증을 지원합니다
아쉬운 점
- 읽기 전용은 선택 사항이며, 기본 execute_sql은 테이블을 DROP할 수 있습니다
- 2026년 6월에 높은 심각도의 보안 권고가 3건 있었습니다
- HTTP 모드는 기본으로 토큰 없이 0.0.0.0에 바인딩합니다
- 승인 흐름, 마스킹, 감사 로그가 없습니다
추천 대상
작고 설정 가능한 서버 하나로 에이전트가 여러 SQL 데이터베이스를 탐색하고 조회하게 하고 싶은 개발자입니다.
DBHub 대안
DBHub: 자주 묻는 질문
- DBHub, 쓸 만한 가치가 있습니까?
- 에이전트를 위한 작고 잘 설계된 SQL 게이트웨이입니다. 단, 읽기 전용 데이터베이스 사용자로 연결해야 합니다. 자체 읽기 전용 모드는 이미 두 번 우회되었습니다. 평점은 5점 만점에 4.3점입니다.
- DBHub의 가격은 얼마입니까?
- 무료 오픈소스(MIT)입니다. Bytebase는 승인 흐름, 마스킹, 감사 로그를 갖춘 별도의 엔터프라이즈 제품을 판매합니다.
- DBHub의 단점은 무엇입니까?
- 읽기 전용은 선택 사항이며, 기본 execute_sql은 테이블을 DROP할 수 있습니다; 2026년 6월에 높은 심각도의 보안 권고가 3건 있었습니다; HTTP 모드는 기본으로 토큰 없이 0.0.0.0에 바인딩합니다; 승인 흐름, 마스킹, 감사 로그가 없습니다.
- DBHub에 적합한 사람은 누구입니까?
- 작고 설정 가능한 서버 하나로 에이전트가 여러 SQL 데이터베이스를 탐색하고 조회하게 하고 싶은 개발자입니다.
- 팀이나 프로덕션 환경에서 DBHub의 비용은 얼마입니까?
- 무료이며, 실제 비용은 데이터베이스 부하입니다. 도구별 max_rows와 query_timeout이 폭주하는 에이전트 쿼리를 막고, 무상태 HTTP 전송으로 여러 복제본이 트래픽을 나눌 수 있습니다.
- DBHub에 회사 데이터를 맡겨도 안전합니까?
- DSN의 데이터베이스 사용자가 할 수 있는 일은 무엇이든 할 수 있으며, readonly = true가 아니면 DDL도 포함됩니다. 모든 것이 사용자의 컴퓨터에서 실행되고, 결과는 클라이언트가 쓰는 모델로 갑니다. 공유 네트워크에서는 HTTP 모드에 --auth-token과 --host 127.0.0.1이 필요합니다.
- DBHub의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 MCP Toolbox for Databases, Supabase MCP Server, Neon MCP Server 및 ClickHouse MCP Server입니다.
답변 확인일: 2026년 10월 22일.
DBHub 개발사입니까? 이 평점을 사이트에 표시하십시오
