dsh-dbhub-live

DeepSeek Harness (DSH)가 데이터베이스를 직접 안전하게 조작할 수 있도록 지원: 상주 다중 소스 연결 + 작업 공간별 도구 + 임시 동적 연결.

dsh-dbhub-live는 DSH 플러그인으로, DBHub(데이터베이스 MCP 서버)를 기반으로 모델이 데이터베이스를 직접 조회할 수 있도록 합니다: 구성된 작업 공간에서 상주 연결을 재사용하거나 임시로 임의의 라이브러리에 연결하여 일회성 문제를 해결할 수 있습니다.

✨ 특징

• 상주 다중 소스 서비스 — 백그라운드의 하나의 dbhub 서비스가 여러 데이터 소스를 동시에 연결하며, 연결을 재사용하여 쿼리가 더 빠릅니다.

• 작업 공간별 도구 — dbhub_execute_sql_<작업공간> / dbhub_search_objects_<작업공간>, 도구 이름이 곧 작업 공간이며, 여러 작업 공간이 혼동되지 않고 연결 레이블(비밀번호 마스킹)이 명확하게 표시됩니다.

• 임시 동적 연결 — dbhub_query / dbhub_query_objects는 매번 독립적으로 임의의 라이브러리에 연결하며, 여러 다른 라이브러리를 병렬로 조회하여 교차 환경 문제 해결에 용이합니다.

• 즉시 사용 가능 — dbhub가 설치되지 않은 경우 첫 사용 시 자동으로 설치되며, 이후 자동으로 업데이트가 유지되므로 수동 처리가 필요 없습니다.

• 다양한 구성 방식 — 명시적 DSN / 세부 항목 입력 / 권한 부여 후 프로젝트 설정 파일 스캔, 자격 증명은 로컬 사용자 디렉토리에만 저장되며 비밀번호는全程 비식별화됩니다.

지원 데이터 소스

MySQL · PostgreSQL · MariaDB · SQLite · SQL Server

환경 요구 사항

• DeepSeek Harness의 dsh CLI(dsh web이 GUI 실행 담당)

• 로컬에 Node.js ≥ 18(포함 npm) 권장 — 첫 사용 시 자동으로 dbhub 설치

설치

# 方式一：使用本机已安装的 dsh
dsh plugin --profile web add dsh-dbhub-live

# 方式二：通过 npx 调用 dsh（无需本机全局安装 dsh）
npx @deepseek-ai/dsh plugin --profile web add dsh-dbhub-live

설치 후 dsh web 재시작해야 적용됩니다.

빠른 시작

# 1) 为当前工作区配置数据库连接（三种方式任选其一）
dbhub_configure

# 2) 在已配置工作区的常驻连接上执行查询
dbhub_execute_sql_myapp  SELECT * FROM users LIMIT 10;

# 3) 临时连任意库做一次性排查
dbhub_query  dsn=mysql://root:pass@192.168.77.6:3306/tx_sd_jinengshu  sql="SHOW TABLES;"

도구

참고: search_objects는 SQLite에서만 사용 가능; MySQL / PostgreSQL 등은 dbhub_query를 사용하여 직접 조회(예: SHOW TABLES).

구성 방식

1. 명시적 DSN — 전체 연결 문자열 입력, 예: mysql://user:pass@host:3306/db.

2. 세부 항목 입력 — 유형 / 호스트 / 포트 / 계정 / 비밀번호 / 라이브러리 이름 순서로 입력.

3. 권한 부여 스캔 — 권한 부여 후 프로젝트 설정 파일(.env, application*.yml, docker-compose, jdbc.properties 등) 스캔, 후보 목록(비밀번호 마스킹) 표시하여 확인 대기.

작업 공간에 이미 mise env 또는 .env(DSN / DB_*)가 있으면 플러그인이 자동으로 감지하므로 수동 구성 불필요.

🔄 dbhub 자동 설치 및 업데이트

• 첫 사용 시 자동 설치: 로컬에 dbhub가 없으면 플러그인이 첫 번째 쿼리 시 자동으로 설치하며, 이후 오프라인에서도 사용 가능.

• 자동 업데이트 유지: 7일마다 백그라운드에서 자동으로 최신 버전으로 업데이트하며, 실패 시 기존 버전 유지.

• 구성 건드리지 않음: PATH / mise를 통해 직접 설치한 dbhub는 플러그인이 변경하지 않음.

데이터 위치

모든 구성과 자격 증명은 모듈 디렉토리 외부에 저장되며(pnpm 패키징 영향 없음), 해당 디렉토리를 삭제하면 완전히 지워집니다:

~/.dsh/storages/dsh-dbhub-live/

제거

dsh plugin --profile web remove dsh-dbhub-live

문제 해결

라이선스

MIT