Repolode
bytebase

bytebase/dbhub

AI 클라이언트가 PostgreSQL, MySQL, SQL Server, Oracle, MariaDB, SQLite 데이터베이스를 조회하고 탐색할 수 있게 해 주는 최소한의 토큰 효율적인 MCP 서버입니다.

스타
3,689
포크
341
열린 이슈
2
마지막 커밋
7일 전

어떤 프로젝트인가요?

DBHub는 Claude Desktop, Claude Code, Cursor, VS Code 같은 MCP 호환 클라이언트가 여러 SQL 데이터베이스에 접근할 수 있도록 단일 게이트웨이를 제공하는 MCP(Model Context Protocol) 서버입니다. PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite를 지원하며, TOML 설정을 통해 여러 데이터베이스에 동시에 연결할 수 있습니다.

기본적으로 execute_sql과 search_objects, 두 가지 도구만 제공하며, 프로젝트 설명에 따르면 약 1.4k 토큰을 사용해 컨텍스트 윈도우를 여유롭게 유지합니다. 선택적으로 활성화할 수 있는 추가 도구로 explain_sql과 health_check가 있으며, dbhub.toml 파일에서 사용자 지정 매개변수화 SQL 도구를 정의할 수도 있습니다. 내장 웹 워크벤치를 사용하면 MCP 클라이언트 없이 쿼리와 도구를 실행할 수 있습니다.

안전 기능으로 읽기 전용 모드, 행 제한, 쿼리 시간 제한, SSH 터널링, SSL/TLS 암호화를 제공합니다. npx, Docker, MCP Bundle 또는 Claude Code 플러그인으로 실행할 수 있으며, Node.js 22.5 이상이 필요합니다.

핵심 기능

  • 01토큰 사용량을 줄이기 위해 기본 MCP 도구 두 개(execute_sql, search_objects)를 제공합니다.
  • 02단일 인터페이스에서 PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite를 지원합니다.
  • 03TOML 설정을 통해 여러 데이터베이스에 동시에 연결합니다.
  • 04안전장치로 읽기 전용 모드, 행 제한, 쿼리 시간 제한을 제공합니다.
  • 05안전한 연결을 위해 SSH 터널링과 SSL/TLS 암호화를 지원합니다.
  • 06쿼리와 사용자 지정 도구를 실행할 수 있는 내장 웹 워크벤치를 제공합니다.

활용 사례

  • 로컬 개발 중 Claude Code, Cursor, VS Code에서 스키마를 살펴보고 데이터를 디버깅합니다.
  • AI 클라이언트를 통해 비기술 담당자에게 선별된 데이터에 대한 읽기 전용 접근 권한을 제공합니다.
  • 여러 데이터베이스를 지원하는 단일 프로세스로 개별 MCP 서버를 대체합니다.
  • 쿼리 폭주를 방지하는 보호 기능을 적용해 프로덕션 환경을 읽기 전용으로 진단합니다.

빠른 시작

  1. 1

    npx로 DBHub를 시작하고 데이터베이스 DSN을 지정합니다

    npx @bytebase/dbhub@latest --transport http --port 8080 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
  2. 2

    또는 Docker 이미지를 실행합니다(Docker 설치 섹션 참조)

사용 전 알아둘 점

  • 개발 빌드에는 Node.js 22.5.0 이상이 필요합니다.

토픽

자주 묻는 질문

dbhub은(는) 무엇인가요?
AI 클라이언트가 PostgreSQL, MySQL, SQL Server, Oracle, MariaDB, SQLite 데이터베이스를 조회하고 탐색할 수 있게 해 주는 최소한의 토큰 효율적인 MCP 서버입니다. DBHub는 Claude Desktop, Claude Code, Cursor, VS Code 같은 MCP 호환 클라이언트가 여러 SQL 데이터베이스에 접근할 수 있도록 단일 게이트웨이를 제공하는 MCP(Model Context Protocol) 서버입니다. PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite를 지원하며, TOML 설정을 통해 여러 데이터베이스에 동시에 연결할 수 있습니다.
dbhub은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
dbhub은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
dbhub은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. dbhub의 마지막 커밋은 2026년 10월 13일입니다.
dbhub은(는) 어디에 사용할 수 있나요?
로컬 개발 중 Claude Code, Cursor, VS Code에서 스키마를 살펴보고 데이터를 디버깅합니다. AI 클라이언트를 통해 비기술 담당자에게 선별된 데이터에 대한 읽기 전용 접근 권한을 제공합니다. 여러 데이터베이스를 지원하는 단일 프로세스로 개별 MCP 서버를 대체합니다. 쿼리 폭주를 방지하는 보호 기능을 적용해 프로덕션 환경을 읽기 전용으로 진단합니다.
dbhub는 어떻게 설치하나요?
npx로 DBHub를 시작하고 데이터베이스 DSN을 지정합니다: npx @bytebase/dbhub@latest --transport http --port 8080 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable" 또는 Docker 이미지를 실행합니다(Docker 설치 섹션 참조)
dbhub은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/bytebase/dbhub

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트