ChatGPT alternative for power users

DBHub는 MCP(Model Context Protocol) 서버 인터페이스를 구현하는 범용 데이터베이스 게이트웨이입니다. 이 게이트웨이를 통해 MCP 호환 클라이언트는 다양한 데이터베이스에 연결하고 탐색할 수 있습니다.

지엑스피1

데모 SSE 엔드포인트

https://demo.dbhub.ai/sse는 샘플 직원 데이터베이스를 연결합니다. Cursor 또는 MCP Inspector를 연결하여 실제 작동 모습을 확인할 수 있습니다.

지원되는 매트릭스

데이터베이스 리소스

리소스 이름	URI 형식	포스트그레스큐엘	MySQL	SQL 서버	SQLite
스키마	`db://schemas`	✅	✅	✅	✅
스키마의 테이블	`db://schemas/{schemaName}/tables`	✅	✅	✅	✅
스키마의 테이블 구조	`db://schemas/{schemaName}/tables/{tableName}`	✅	✅	✅	✅
테이블의 인덱스	`db://schemas/{schemaName}/tables/{tableName}/indexes`	✅	✅	✅	✅
스키마의 프로시저	`db://schemas/{schemaName}/procedures`	✅	✅	✅	❌
스키마의 프로시저 세부 정보	`db://schemas/{schemaName}/procedures/{procedureName}`	✅	✅	✅	❌

데이터베이스 도구

도구	명령 이름	포스트그레스큐엘	MySQL	SQL 서버	SQLite
쿼리 실행	`run_query`	✅	✅	✅	✅
목록 커넥터	`list_connectors`	✅	✅	✅	✅

신속한 기능

즉각적인	명령 이름	포스트그레스큐엘	MySQL	SQL 서버	SQLite
SQL 생성	`generate_sql`	✅	✅	✅	✅
DB 요소 설명	`explain_db`	✅	✅	✅	✅

설치

도커

# PostgreSQL example
docker run --rm --init \
   --name dbhub \
   --publish 8080:8080 \
   bytebase/dbhub \
   --transport sse \
   --port 8080 \
   --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"

# Demo mode with sample employee database
docker run --rm --init \
   --name dbhub \
   --publish 8080:8080 \
   bytebase/dbhub \
   --transport sse \
   --port 8080 \
   --demo

국립민간공원

# PostgreSQL example
npx @bytebase/dbhub --transport sse --port 8080 --dsn "postgres://user:password@localhost:5432/dbname"

# Demo mode with sample employee database
npx @bytebase/dbhub --transport sse --port 8080 --demo

참고: 데모 모드에는 직원, 부서, 급여 등에 대한 테이블이 있는 SQLite 샘플 "직원" 데이터베이스가 함께 제공됩니다.

클로드 데스크탑

Claude Desktop은 stdio 전송만 지원합니다 . https://github.com/orgs/modelcontextprotocol/discussions/16

// claude_desktop_config.json
{
  "mcpServers": {
    "dbhub-postgres-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "bytebase/dbhub",
        "--transport",
        "stdio",
        "--dsn",
        // Use host.docker.internal as the host if connecting to the local db
        "postgres://user:password@host.docker.internal:5432/dbname?sslmode=disable"
      ]
    },
    "dbhub-postgres-npx": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub",
        "--transport",
        "stdio",
        "--dsn",
        "postgres://user:password@localhost:5432/dbname?sslmode=disable"
      ]
    },
    "dbhub-demo": {
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub", "--transport", "stdio", "--demo"]
    }
  }
}

커서

커서는 stdio 와 sse 모두 지원합니다.
커서 MCP 가이드를 따르고 에이전트 모드를 사용하세요.

용법

데이터베이스 연결 구성

테스트를 위해 샘플 직원 데이터베이스와 함께 데모 모드에서 DBHub를 사용할 수 있습니다.

npx @bytebase/dbhub  --demo

실제 데이터베이스의 경우 데이터베이스 원본 이름(DSN)이 필요합니다. 다음과 같은 여러 가지 방법으로 제공할 수 있습니다.

명령줄 인수 (가장 높은 우선순위):
npx @bytebase/dbhub --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
환경 변수 (두 번째 우선순위):
export DSN="postgres://user:password@localhost:5432/dbname?sslmode=disable" npx @bytebase/dbhub
환경 파일 (3번째 우선순위):
- 개발용: DSN으로 .env.local 만듭니다.
- 프로덕션의 경우: DSN GXP10을 사용하여 .env 만듭니다.

[!경고] Docker에서 실행할 때 호스트 머신에서 실행 중인 데이터베이스에 연결하려면 localhost 대신 host.docker.internal 사용하세요. 예: mysql://user:password@host.docker.internal:3306/dbname

DBHub는 다음과 같은 데이터베이스 연결 문자열 형식을 지원합니다.

데이터 베이스	DSN 형식	예
포스트그레스큐엘	`postgres://[user]:[password]@[host]:[port]/[database]`	`postgres://user:password@localhost:5432/dbname?sslmode=disable`
SQLite	`sqlite:///[path/to/file]` 또는 `sqlite::memory:`	`sqlite:///path/to/database.db` 또는 `sqlite::memory:`
SQL 서버	`sqlserver://[user]:[password]@[host]:[port]/[database]`	`sqlserver://user:password@localhost:1433/dbname`
MySQL	`mysql://[user]:[password]@[host]:[port]/[database]`	`mysql://user:password@localhost:3306/dbname`

수송

stdio (기본값) - Claude Desktop과 같은 도구와 직접 통합하기 위해:
npx @bytebase/dbhub --transport stdio --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
sse - 브라우저 및 네트워크 클라이언트용:
npx @bytebase/dbhub --transport sse --port 5678 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"

명령줄 옵션

옵션	설명	기본
데모	샘플 직원 데이터베이스로 데모 모드에서 실행	`false`
디에스엔	데이터베이스 연결 문자열	데모 모드가 아닌 경우 필요합니다.
수송	전송 모드: `stdio` 또는 `sse`	`stdio`
포트	HTTP 서버 포트( `--transport=sse` 사용할 때만 적용 가능)	`8080`

데모 모드에서는 직원, 부서, 직함, 급여, 부서 직원 및 부서 관리자에 대한 테이블이 포함된 샘플 직원 데이터베이스가 로드된 인메모리 SQLite 데이터베이스를 사용합니다. 샘플 데이터베이스에는 테이블 생성, 데이터 로드 및 테스트를 위한 SQL 스크립트가 포함되어 있습니다.

개발

종속성 설치:
pnpm install
개발 모드에서 실행:
pnpm dev
프로덕션을 위해 빌드:
pnpm build pnpm start --transport stdio --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"

MCP Inspector 로 디버그

stdio

# PostgreSQL example
TRANSPORT=stdio DSN="postgres://user:password@localhost:5432/dbname?sslmode=disable" npx @modelcontextprotocol/inspector node /path/to/dbhub/dist/index.js

남남동

# Start DBHub with SSE transport
pnpm dev --transport=sse --port=8080

# Start the MCP Inspector in another terminal
npx @modelcontextprotocol/inspector

DBHub 서버 /sse 엔드포인트에 연결합니다.

DBHub

Integrations