본문으로 건너뛰기
MCP 서버 전체 목록

DBHub

토큰을 아끼는 최소 구성 데이터베이스 MCP 서버. PostgreSQL · MySQL · MariaDB · SQL Server · Oracle · SQLite를 기본 도구 2개로 다뤄요. MIT

원본:bytebase/dbhub

설치 방법은 설치 탭에 정리했어요.

설명

💡 DBHub가 제공하는 것을 넘어서는, 승인 흐름 · 접근 제어 · 데이터 마스킹 · 감사 로그 같은 안전장치가 갖춰진 기업용 데이터베이스 MCP 서버가 필요하다면 Bytebase를 살펴보세요.

GitHub 오늘의 트렌딩 저장소

DBHub 로고

            +------------------+    +--------------+    +------------------+
            |                  |    |              |    |                  |
            |  Claude Desktop  +--->+              +--->+    PostgreSQL    |
            |                  |    |              |    |                  |
            |  Claude Code     +--->+              +--->+    SQL Server    |
            |                  |    |              |    |                  |
            |  Cursor          +--->+    DBHub     +--->+    Oracle        |
            |                  |    |              |    |                  |
            |  VS Code         +--->+              +--->+    SQLite        |
            |                  |    |              |    |                  |
            |  Copilot CLI     +--->+              +--->+    MySQL         |
            |                  |    |              |    |                  |
            |                  |    |              +--->+    MariaDB       |
            |                  |    |              |    |                  |
            +------------------+    +--------------+    +------------------+
                 MCP Clients           MCP Server             Databases

DBHub는 최소 구성의 MCP 서버입니다. 토큰을 아끼고, 의존성이 없으며, 기본으로는 도구가 딱 두 개이고 나머지는 필요할 때 켜서 씁니다. 이 가벼운 게이트웨이로 MCP를 지원하는 클라이언트가 여러 데이터베이스에 연결해 살펴볼 수 있습니다.

  • 최소 구성: 의존성이 없고, MCP 도구를 최소한으로 두어 토큰을 아끼며 컨텍스트 창을 최대한 비워 둡니다
  • 여러 데이터베이스: PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite를 하나의 인터페이스로 다룹니다
  • 여러 연결: TOML 설정으로 여러 데이터베이스에 동시에 연결합니다
  • 안전장치: 읽기 전용 모드, 행 수 제한, 쿼리 제한 시간으로 폭주하는 작업을 막습니다
  • 안전한 접속: SSH 터널링과 SSL/TLS 암호화를 지원합니다

DBHub는 PostgreSQL을 MCP로 연결하는 Claude Code 문서의 공식 예시입니다.

토큰 효율

DBHub는 기본으로 도구 2개만 1.4k 토큰으로 불러옵니다. 대안보다 13~14배 적은 양이라, 실제 작업을 위한 컨텍스트 창이 넉넉하게 남습니다.

MCP 서버기본 설정기본 도구
DBHub1.4k2개 (execute_sql, search_objects)
MCP Toolbox19.0k28개
Supabase MCP19.3k전부

활용 사례

  • 로컬 개발: Claude Code, VS Code, Cursor 등으로 스키마 탐색, 쿼리 검증, 데이터 디버깅을 합니다
  • 비개발자 접근: Claude Desktop, VS Code, Cursor 등으로 비개발 직원에게 선별한 읽기 전용 화면을 열어 줍니다
  • 여러 데이터베이스 통합: 데이터베이스마다 따로 둔 MCP 서버를 DBHub 프로세스 하나로 바꿉니다
  • 운영 환경 문제 해결: 폭주하는 쿼리를 막는 안전장치를 둔 읽기 전용 진단을 합니다

지원하는 데이터베이스

PostgreSQL, MySQL, SQL Server, MariaDB, Oracle, SQLite.

MCP 도구

DBHub는 데이터베이스 작업용 MCP 도구를 제공합니다.

  • execute_sql: 트랜잭션 지원과 안전 제어를 갖춰 SQL 쿼리를 실행합니다
  • search_objects: 스키마, 테이블, 열, 인덱스, 프로시저를 단계적으로 펼쳐 가며 검색하고 탐색합니다
  • explain_sql (선택): 쿼리를 실행하지 않고 실행 계획만 보여 줍니다
  • health_check (선택): 연결 풀 상태와 버퍼 캐시 적중률을 알려 줍니다
  • 사용자 정의 도구: dbhub.toml 설정 파일에 재사용할 수 있는 매개변수형 SQL 작업을 정의합니다

워크벤치

DBHub에는 데이터베이스 도구와 상호작용하는 내장 웹 인터페이스가 들어 있습니다. MCP 클라이언트 없이도 쿼리를 실행하고, 사용자 정의 도구를 돌리고, 요청 추적을 시각적으로 볼 수 있습니다.

워크벤치

설치

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

이런 방식으로도 쓸 수 있습니다.

모든 옵션은 설치 안내, 매개변수는 명령줄 옵션, 여러 데이터베이스를 한 번에 연결하는 방법은 다중 데이터베이스 설정을 보세요.

개발

Node.js 22.5.0 이상이 필요합니다(DBHub는 내장 node:sqlite 모듈을 씁니다).

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build and run for production
pnpm build && pnpm start --transport stdio --dsn "postgres://user:password@localhost:5432/dbname"

테스트와 디버그를 보세요.

기여자

기여자 목록

스타 히스토리

스타 히스토리 차트


저장소: bytebase/dbhub