bytebase/dbhub

DBHub – AI 기반 데이터베이스 액세스를 위한 작고 토큰 효율적인 MCP 서버

개요 – DBHub는 AI 기반 도구(Claude Desktop/Code, Cursor, VS Code, Copilot CLI 등)가 실제 관계형 데이터베이스와 통신할 수 있도록 하는 경량 Model-Connect-Protocol (MCP) 서버입니다. 단일 프로세스로 실행되며 외부 의존성이 전혀 없고, LLM이 데이터를 안전하게 탐색하거나 쿼리하는 데 필요한 필수 도구만 노출합니다.

AI/ML에서의 중요성 – 현대의 LLM 기반 에이전트는 모델의 컨텍스트 윈도우를 소모하지 않고 SQL을 실행할 방법이 필요합니다. DBHub의 기본 도구 세트(execute_sql 및 search_objects만 포함)는 약 1.4k 토큰으로, 경쟁 MCP 서버보다 10배 이상 작습니다. 이는 모델의 프롬프트 공간을 실제 추론 작업에 더 많이 할당할 수 있게 하여, DBHub를 언어 모델과 프로덕션 데이터베이스 간의 실용적인 가교로 만듭니다.

주요 기능

• 토큰 효율적인 코어 – 2개의 내장 도구로 1.4k 토큰.
• 다중 데이터베이스 지원 – PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite.
• 단일 TOML 파일을 통한 다중 연결 – 하나의 DBHub 프로세스로 여러 데이터베이스 운영.
• 안전 가드레일 – 읽기 전용 모드, 행 제한, 쿼리 타임아웃, SSH 터널링, TLS 암호화.
• 선택적 추가 도구 – explain_sql, health_check 및 사용자 정의 도구.
• 내장 웹 워크벤치 – 시각적 쿼리 콘솔 및 요청 추적 뷰어.
• 제로 런타임 의존성 – Node ≥ 22.5만 필요 (내장 node:sqlite 사용).

일반적인 사용 사례

1. 로컬 개발 – Claude Code나 VS Code를 사용하여 에디터를 떠나지 않고 스키마 탐색, 쿼리 검증 및 데이터 디버깅 수행.
2. 비기술자용 대시보드 – AI 어시스턴트를 통해 비즈니스 사용자에게 읽기 전용, 속도 제한된 뷰를 공개.
3. 통합 데이터베이스 게이트웨이 – 여러 개의 개별 MCP 서버를 하나의 DBHub 인스턴스로 대체.
4. 프로덕션 문제 해결 – 서비스 오작동 시 LLM을 통해 안전한 읽기 전용 진단 실행.

시작하기

# 빠른 원라인 명령어 (npm) – 포트 8080에서 HTTP 기반 MCP 서버 실행
npx @bytebase/dbhub@latest \
  --transport http \
  --port 8080 \
  --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"

기타 배포 옵션:

• Docker 이미지 (Docker Hub에서 풀)
• MCP Bundle (원클릭, 읽기 전용 모드)
• Claude Code 플러그인 (Claude UI에 직접 통합)

개발 워크플로우

pnpm install          # 개발 의존성 설치
pnpm dev              # 핫 리로드로 실행
pnpm build && pnpm start --transport stdio --dsn "postgres://…"

저장소에는 다중 데이터베이스 구성을 위한 dbhub.toml, /docs/images/workbench 하위의 웹 워크벤치, 그리고 테스트/디버그 문서가 포함되어 있습니다.

개발 배경 – 이 프로젝트는 엔터프라이즈급 데이터베이스 MCP 플랫폼을 제공하는 Bytebase에서 유지 관리합니다. README는 더 강력한 가드레일이 필요한 팀을 위해 전체 Bytebase 제품으로 연결됩니다.

---

모든 세부 정보는 저장소의 README에서 직접 가져온 것이며, 추가 기능은 추론되지 않았습니다.