DBHub

DBHub es una puerta de enlace de base de datos universal que implementa la interfaz de servidor del Protocolo de Contexto de Modelo (MCP). Esta puerta de enlace permite a los clientes compatibles con MCP conectarse a diferentes bases de datos y explorarlas.

 +------------------+    +--------------+    +------------------+
 |                  |    |              |    |                  |
 |                  |    |              |    |                  |
 |  Claude Desktop  +--->+              +--->+    PostgreSQL    |
 |                  |    |              |    |                  |
 |      Cursor      +--->+    DBHub     +--->+    SQL Server    |
 |                  |    |              |    |                  |
 |     Other MCP    +--->+              +--->+     SQLite       |
 |      Clients     |    |              |    |                  |
 |                  |    |              +--->+     MySQL        |
 |                  |    |              |    |                  |
 |                  |    |              +--->+    MariaDB       |
 |                  |    |              |    |                  |
 |                  |    |              +--->+     Oracle       |
 |                  |    |              |    |                  |
 +------------------+    +--------------+    +------------------+
      MCP Clients           MCP Server             Databases

Punto final de demostración de SSE

https://demo.dbhub.ai/sse conecta una base de datos de empleados de ejemplo . Puedes usar Cursor o MCP Inspector para verla en acción.

inspector mcp

Matriz soportada

Recursos de bases de datos

Nombre del recurso	Formato URI	PostgreSQL	MySQL	MariaDB	Servidor SQL	SQLite	Oráculo
esquemas	`db://schemas`	✅	✅	✅	✅	✅	✅
tablas_en_esquema	`db://schemas/{schemaName}/tables`	✅	✅	✅	✅	✅	✅
estructura_de_tabla_en_esquema	`db://schemas/{schemaName}/tables/{tableName}`	✅	✅	✅	✅	✅	✅
índices_en_tabla	`db://schemas/{schemaName}/tables/{tableName}/indexes`	✅	✅	✅	✅	✅	✅
procedimientos_en_esquema	`db://schemas/{schemaName}/procedures`	✅	✅	✅	✅	❌	✅
detalles_del_procedimiento_en_el_esquema	`db://schemas/{schemaName}/procedures/{procedureName}`	✅	✅	✅	✅	❌	✅

Herramientas de base de datos

Herramienta	Nombre del comando	PostgreSQL	MySQL	MariaDB	Servidor SQL	SQLite	Oráculo
Ejecutar SQL	`execute_sql`	✅	✅	✅	✅	✅	✅
Conectores de lista	`list_connectors`	✅	✅	✅	✅	✅	✅

Capacidades rápidas

Inmediato	Nombre del comando	PostgreSQL	MySQL	MariaDB	Servidor SQL	SQLite	Oráculo
Generar SQL	`generate_sql`	✅	✅	✅	✅	✅	✅
Explicar los elementos de la base de datos	`explain_db`	✅	✅	✅	✅	✅	✅

Instalación

Estibador

# 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

# Oracle example
docker run --rm --init \
   --name dbhub \
   --publish 8080:8080 \
   bytebase/dbhub \
   --transport sse \
   --port 8080 \
   --dsn "oracle://username:password@localhost:1521/service_name"

# Oracle example with thick mode for connecting to 11g or older 
docker run --rm --init \
   --name dbhub \
   --publish 8080:8080 \
   bytebase/dbhub-oracle-thick \
   --transport sse \
   --port 8080 \
   --dsn "oracle://username:password@localhost:1521/service_name"

NGP

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

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

Nota: El modo de demostración incluye una base de datos de "empleados" de muestra SQLite con tablas para empleados, departamentos, salarios y más.

Escritorio de Claude

Claude-escritorio

Claude Desktop solo admite el transporte stdiohttps://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"]
    }
  }
}

Cursor

cursor

El cursor admite tanto stdio como sse .
Siga la guía de Cursor MCP y asegúrese de utilizar el modo Agente .

Uso

Conexiones SSL

Puede especificar el modo SSL utilizando el parámetro sslmode en su cadena DSN:

Base de datos	`sslmode=disable`	`sslmode=require`	Comportamiento SSL predeterminado
PostgreSQL	✅	✅	Verificación del certificado
MySQL	✅	✅	Verificación del certificado
MariaDB	✅	✅	Verificación del certificado
Servidor SQL	✅	✅	Verificación del certificado
Oráculo	✅	✅	N/A (utilizar la configuración del cliente Oracle)
SQLite	❌	❌	N/A (basado en archivos)

Opciones del modo SSL:

sslmode=disable : El cifrado SSL/TLS está desactivado. Los datos se transmiten en texto plano.
sslmode=require : La conexión está cifrada, pero el certificado del servidor no está verificado. Esto proporciona protección contra el rastreo de paquetes, pero no contra ataques de intermediario. Puede usarlo para una CA autofirmada de confianza.

Sin especificar sslmode , la mayoría de las bases de datos utilizan de manera predeterminada la verificación del certificado, que proporciona el mayor nivel de seguridad.

Ejemplo de uso:

# Disable SSL
postgres://user:password@localhost:5432/dbname?sslmode=disable

# Require SSL without certificate verification
postgres://user:password@localhost:5432/dbname?sslmode=require

# Standard SSL with certificate verification (default)
postgres://user:password@localhost:5432/dbname

Modo de solo lectura

Puede ejecutar DHub en modo de solo lectura, lo que restringe la ejecución de consultas SQL a operaciones de solo lectura:

# Enable read-only mode
npx @bytebase/dbhub --readonly --dsn "postgres://user:password@localhost:5432/dbname"

En el modo de solo lectura, únicamente se permiten operaciones SQL de solo lectura .

Esto proporciona una capa adicional de seguridad al conectarse a bases de datos de producción.

Configurar su conexión de base de datos

Puede utilizar DHub en modo de demostración con una base de datos de empleados de muestra para realizar pruebas:

npx @bytebase/dbhub  --demo

Para bases de datos reales, se requiere un Nombre de Origen de la Base de Datos (DSN). Puede proporcionarlo de varias maneras:

Argumento de línea de comando (máxima prioridad):
npx @bytebase/dbhub --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
Variable de entorno (segunda prioridad):
export DSN="postgres://user:password@localhost:5432/dbname?sslmode=disable" npx @bytebase/dbhub
Expediente de entorno (tercera prioridad):
- Para desarrollo: crea .env.local con tu DSN
- Para producción: crea .env con tu DSN GXP14

[!ADVERTENCIA] Al ejecutar en Docker, use host.docker.internal en lugar de localhost para conectarse a las bases de datos que se ejecutan en su equipo host. Por ejemplo: mysql://user:password@host.docker.internal:3306/dbname

DBHub admite los siguientes formatos de cadenas de conexión de base de datos:

Base de datos	Formato DSN	Ejemplo
MySQL	`mysql://[user]:[password]@[host]:[port]/[database]`	`mysql://user:password@localhost:3306/dbname?sslmode=disable`
MariaDB	`mariadb://[user]:[password]@[host]:[port]/[database]`	`mariadb://user:password@localhost:3306/dbname?sslmode=disable`
PostgreSQL	`postgres://[user]:[password]@[host]:[port]/[database]`	`postgres://user:password@localhost:5432/dbname?sslmode=disable`
Servidor SQL	`sqlserver://[user]:[password]@[host]:[port]/[database]`	`sqlserver://user:password@localhost:1433/dbname?sslmode=disable`
SQLite	`sqlite:///[path/to/file]` o `sqlite::memory:`	`sqlite:///path/to/database.db` , `sqlite:C:/Users/YourName/data/database.db (windows)` o `sqlite::memory:`
Oráculo	`oracle://[user]:[password]@[host]:[port]/[service_name]`	`oracle://username:password@localhost:1521/service_name?sslmode=disable`

Oráculo

Si ve el error "NJS-138: las conexiones a esta versión del servidor de base de datos no son compatibles con node-oracledb en modo Thin", debe usar el modo Thick como se describe a continuación.

Estibador

Utilice bytebase/dbhub-oracle-thick en lugar de la imagen de Docker bytebase/dbhub .

npx

Descargue e instale Oracle Instant Client para su plataforma
Establezca la variable de entorno ORACLE_LIB_DIR en la ruta de su Oracle Instant Client:

# Set environment variable to Oracle Instant Client directory
export ORACLE_LIB_DIR=/path/to/instantclient_19_8

# Then run DBHub
npx @bytebase/dbhub --dsn "oracle://username:password@localhost:1521/service_name"

Servidor SQL

Parámetros de consulta adicionales:

autenticación

authentication=azure-active-directory-access-token . Solo aplicable al ejecutar desde Azure. Consulte DefaultAzureCredential .

Transporte

stdio (predeterminado): para integración directa con herramientas como Claude Desktop:
npx @bytebase/dbhub --transport stdio --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
sse - para clientes de navegador y red:
npx @bytebase/dbhub --transport sse --port 5678 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"

Opciones de línea de comandos

Opción	Descripción	Por defecto
manifestación	Ejecutar en modo de demostración con una base de datos de empleados de muestra	`false`
dsn	Cadena de conexión a la base de datos	Obligatorio si no está en modo de demostración
transporte	Modo de transporte: `stdio` o `sse`	`stdio`
puerto	Puerto del servidor HTTP (solo aplicable cuando se utiliza `--transport=sse` )	`8080`
solo lectura	Restringir la ejecución de SQL a operaciones de solo lectura	`false`

El modo de demostración utiliza una base de datos SQLite en memoria que contiene la base de datos de empleados de ejemplo , que incluye tablas para empleados, departamentos, cargos, salarios, empleados de departamento y gerentes de departamento. La base de datos de ejemplo incluye scripts SQL para la creación de tablas, la carga de datos y las pruebas.

Desarrollo

Instalar dependencias:
pnpm install
Ejecutar en modo de desarrollo:
pnpm dev
Construir para producción:
pnpm build pnpm start --transport stdio --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"

Pruebas

El proyecto utiliza Vitest para realizar pruebas:

Ejecutar pruebas: pnpm test
Ejecutar pruebas en modo de vigilancia: pnpm test:watch

Ganchos de pre-confirmación (para desarrolladores)

El proyecto incluye ganchos previos a la confirmación para ejecutar pruebas automáticamente antes de cada confirmación:

Después de clonar el repositorio, configure los ganchos previos a la confirmación:
./scripts/setup-husky.sh
Esto garantiza que el conjunto de pruebas se ejecute automáticamente cada vez que crea una confirmación, lo que evita confirmaciones que podrían interrumpir las pruebas.

Depurar con MCP Inspector

estudio

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

SSE

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

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

Conectarse al punto final del servidor /sse DBHub

Colaboradores

Historia de las estrellas

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Servidor de base de datos universal MCP que se conecta a MySQL, PostgreSQL, SQLite, DuckDB, etc.

Related Resources

Reddit Discussion about this server

Related MCP Servers

sqlite-explorer-fastmcp-mcp-server
hannesrudolph
-
security
F
license
-
quality
An MCP server that provides safe, read-only access to SQLite databases through MCP. This server is built with the FastMCP framework, which enables LLMs to explore and query SQLite databases with built-in safety features and query validation.
Last updated -
49
Python
mcp-server-motherduckofficial
motherduckdb
-
security
A
license
-
quality
An MCP server for MotherDuck and local DuckDB.
Last updated -
3
167
Python
MIT License
mcp-jdbc
quarkiverse
-
security
A
license
-
quality
MCP to access any database accessible via JDBC such as Postgres, Oracle, mysql, mariadb, sqlite etc.
Last updated -
129
Apache 2.0
MySQL Database Access
dpflucas
A
security
A
license
A
quality
An MCP server that provides read-only access to MySQL databases.
Last updated -
4
419
17
JavaScript
MIT License

View all related MCP servers

DBHub

Punto final de demostración de SSE

Matriz soportada

Recursos de bases de datos

Herramientas de base de datos

Capacidades rápidas

Instalación

Estibador

NGP

Escritorio de Claude

Cursor

Uso

Conexiones SSL

Modo de solo lectura

Configurar su conexión de base de datos

Oráculo

Estibador

npx

Servidor SQL

autenticación

Transporte

Opciones de línea de comandos

Desarrollo

Pruebas

Ganchos de pre-confirmación (para desarrolladores)

Depurar con MCP Inspector

estudio

SSE

Colaboradores

Historia de las estrellas

Related Resources

Related MCP Servers

sqlite-explorer-fastmcp-mcp-server

mcp-server-motherduckofficial

mcp-jdbc

MySQL Database Access

Appeared in Searches

New MCP Servers

MCP directory API