Skip to main content
Glama
mr-mihu

dsh-dbhub-live

by mr-mihu

dsh-dbhub-live

Permite que DeepSeek Harness (DSH) opere bases de datos de forma directa y segura: conexiones persistentes de múltiples fuentes + herramientas por espacio de trabajo + conexiones dinámicas temporales.

License: MIT DSH DBHub

dsh-dbhub-live es un plugin de DSH basado en DBHub (servidor MCP de base de datos) que permite a los modelos consultar bases de datos directamente: tanto reutilizar conexiones persistentes en espacios de trabajo configurados como conectar temporalmente a cualquier base de datos para inspecciones puntuales.

✨ Características

  • Servicio persistente de múltiples fuentes — Un único servicio dbhub en segundo plano se conecta a múltiples fuentes de datos, reutilizando conexiones para consultas más rápidas.

  • Herramientas por espacio de trabajo — dbhub_execute_sql_<espacio_de_trabajo> / dbhub_search_objects_<espacio_de_trabajo>, el nombre de la herramienta es el espacio de trabajo, múltiples espacios de trabajo no se confunden, las etiquetas de conexión (contraseñas enmascaradas) son claramente visibles.

  • Conexiones dinámicas temporales — dbhub_query / dbhub_query_objects se conectan de forma independiente a cualquier base de datos cada vez, permitiendo consultas paralelas a múltiples bases de datos diferentes, facilitando la depuración entre entornos.

  • Listo para usar — Si dbhub no está instalado, se instala automáticamente en el primer uso, y luego se mantiene actualizado automáticamente, sin necesidad de intervención manual.

  • Múltiples formas de configuración — DSN explícito / completar campos / escanear archivos de configuración del proyecto con autorización. Las credenciales se almacenan solo en el directorio de usuario local, las contraseñas están enmascaradas en todo momento.

Related MCP server: mcp-ohmy-sql

Fuentes de datos compatibles

MySQL · PostgreSQL · MariaDB · SQLite · SQL Server

Requisitos del entorno

  • CLI dsh de DeepSeek Harness (dsh web se encarga de la ejecución de la GUI)

  • Se recomienda tener Node.js ≥ 18 (con npm) en la máquina local — en el primer uso se instalará dbhub automáticamente.

Instalación

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

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

Después de la instalación, reinicia dsh web para que surta efecto.

Inicio rápido

# 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;"

Herramientas

Herramienta

Descripción

dbhub_configure(workspace?, dsn?)

Configura/persiste una conexión de base de datos para un espacio de trabajo.

dbhub_execute_sql_<espacio_de_trabajo>

Ejecuta SQL en la conexión persistente del espacio de trabajo especificado.

dbhub_search_objects_<espacio_de_trabajo>

Busca objetos de base de datos (tablas, vistas, columnas, índices, etc.) en el espacio de trabajo especificado.

dbhub_query(dsn, sql)

Conecta temporalmente a cualquier base de datos y ejecuta SQL (múltiples sentencias separadas por ;).

dbhub_query_objects(dsn, ...)

Conecta temporalmente a cualquier base de datos y busca objetos de base de datos.

Nota: search_objects solo está disponible para SQLite; para MySQL / PostgreSQL, etc., usa dbhub_query directamente (por ejemplo, SHOW TABLES).

Formas de configuración

  1. DSN explícito — Proporciona la cadena de conexión completa, por ejemplo mysql://user:pass@host:3306/db.

  2. Completar campos — Rellena secuencialmente tipo / host / puerto / usuario / contraseña / nombre de base de datos.

  3. Escaneo autorizado — Después de autorizar, escanea los archivos de configuración del proyecto (.env, application*.yml, docker-compose, jdbc.properties, etc.), lista candidatos (contraseñas enmascaradas) para que los confirmes.

Si el espacio de trabajo ya tiene mise env o .env (DSN / DB_*), el plugin lo detectará automáticamente, sin necesidad de configuración manual.

🔄 Instalación y actualización automática de dbhub

  • Instalación automática en el primer uso: Si la máquina no tiene dbhub, el plugin lo instalará automáticamente en la primera consulta, y luego estará disponible sin conexión.

  • Actualización automática: Se actualiza silenciosamente en segundo plano cada 7 días a la última versión; si falla, se mantiene la versión actual.

  • No modifica tu configuración: El dbhub instalado manualmente a través de PATH / mise no será alterado por el plugin.

Variable de entorno

Descripción

Valor predeterminado

DSH_DBHUB_PACKAGE

Nombre del paquete npm usado para la instalación automática

@bytebase/dbhub

DSH_DBHUB_UPDATE_DAYS

Intervalo de actualización automática en días; 0 para desactivar

7

Ubicación de los datos

Toda la configuración y credenciales se almacenan fuera del directorio del módulo (no afectado por el empaquetado de pnpm). Eliminar ese directorio borrará todo:

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

Desinstalación

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

Solución de problemas

Síntoma

Solución

En el primer uso aparece "No se puede obtener dbhub"

Asegúrate de que la máquina tenga npm y conexión a internet; sin conexión, instala dbhub manualmente y agrégalo al PATH.

La herramienta muestra "Servicio dbhub no disponible"

Revisa los logs de dsh web; si el proceso termina inesperadamente, el plugin lo reiniciará automáticamente en la siguiente llamada.

No se escanean archivos de configuración

Por defecto se omiten directorios como node_modules / .git / target / dist; puedes usar "Ingresar DSN" o "Completar campos".

Necesitas una versión personalizada de dbhub

Elimina ~/.dsh/storages/dsh-dbhub-live y luego establece DSH_DBHUB_PACKAGE para especificar el paquete/versión.

No deseas que dbhub se actualice automáticamente

Establece la variable de entorno DSH_DBHUB_UPDATE_DAYS=0.

Licencia

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    MCP Database Server is a service that provides secure database access for AI assistants and LLM-based tools, supporting SQLite, PostgreSQL, MySQL and MariaDB, and featuring query verification, audit logs and security control functions.
    2
    Apache 2.0
  • -
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that bridges AI assistants with SQL databases, enabling natural language querying across multiple database types with built-in optimization and security.
    3
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    A unified MCP server for querying and managing multiple database types (PostgreSQL, MySQL, SQL Server, etc.) via natural language through AI assistants.
    GPL 3.0