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.

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"

NGP

# 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

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 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

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

Uso

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 GXP12

[!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`
MariaDB	`mariadb://[user]:[password]@[host]:[port]/[database]`	`mariadb://user:password@localhost:3306/dbname`
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`
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`

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"

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 DBHub /sse

DBHub

Integrations

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

Modo de solo lectura

Configurar su conexión de base de datos

Servidor SQL

autenticación

Transporte

Opciones de línea de comandos

Desarrollo

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