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        |
 |                  |    |              |    |                  |
 |                  |    |              +--->+  Other Databases |
 |                  |    |              |    |                  |
 +------------------+    +--------------+    +------------------+
      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	Servidor SQL	SQLite
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	Servidor SQL	SQLite
Ejecutar consulta	`run_query`	✅	✅	✅	✅
Conectores de lista	`list_connectors`	✅	✅	✅	✅

Capacidades rápidas

Inmediato	Nombre del comando	PostgreSQL	MySQL	Servidor SQL	SQLite
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

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

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 GXP10

[!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
PostgreSQL	`postgres://[user]:[password]@[host]:[port]/[database]`	`postgres://user:password@localhost:5432/dbname?sslmode=disable`
SQLite	`sqlite:///[path/to/file]` o `sqlite::memory:`	`sqlite:///path/to/database.db` o `sqlite::memory:`
Servidor 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`

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`

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