DBHub
- 추천0
- GitHub 별3.9K
- 데이터베이스라이선스MIT
토큰을 아끼는 최소 구성 데이터베이스 MCP 서버. PostgreSQL · MySQL · MariaDB · SQL Server · Oracle · SQLite를 기본 도구 2개로 다뤄요. MIT
설치 방법은 설치 탭에 정리했어요.
설명
💡 DBHub가 제공하는 것을 넘어서는, 승인 흐름 · 접근 제어 · 데이터 마스킹 · 감사 로그 같은 안전장치가 갖춰진 기업용 데이터베이스 MCP 서버가 필요하다면 Bytebase를 살펴보세요.
+------------------+ +--------------+ +------------------+
| | | | | |
| 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 서버 | 기본 설정 | 기본 도구 |
|---|---|---|
| DBHub | 1.4k | 2개 (execute_sql, search_objects) |
| MCP Toolbox | 19.0k | 28개 |
| Supabase MCP | 19.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"
이런 방식으로도 쓸 수 있습니다.
- Docker 이미지
- MCP 번들 (한 번에 설치, 읽기 전용)
- Claude Code 플러그인
모든 옵션은 설치 안내, 매개변수는 명령줄 옵션, 여러 데이터베이스를 한 번에 연결하는 방법은 다중 데이터베이스 설정을 보세요.
개발
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