Database

Servidor MCP de base de datos para MySQL, MariaDB, PostgreSQL y SQLite

Documentación

Database MCP

Un servidor MCP de un solo binario para bases de datos SQL. Conecta tu asistente de IA a MySQL/MariaDB, PostgreSQL o SQLite sin dependencias de ejecución.

Sitio web · Documentación · Lanzamientos

demo

Características ✨

Multi-base de datos — MySQL/MariaDB, PostgreSQL y SQLite desde un solo binario
Herramientas MCP — descubrimiento de esquemas (listDatabases, listTables, listViews, listTriggers, listFunctions, listProcedures, listMaterializedViews), acceso a datos (readQuery, writeQuery), DDL (createDatabase, dropDatabase, dropTable) y explainQuery. El modo de solo lectura oculta las herramientas de escritura (writeQuery, createDatabase, dropDatabase, dropTable). Consulta Herramientas MCP para conocer la disponibilidad por backend.
Un solo binario — ~7 MB, sin necesidad de Python/Node/Docker
Múltiples transportes — stdio (para Claude Desktop, Cursor) y HTTP (para remoto/multicliente)
Configuración en dos capas — banderas de CLI > variables de entorno, con valores predeterminados sensatos por backend

Instalación 📦

macOS, Linux, WSL:

curl -fsSL https://dbmcp.haymon.ai/install.sh | bash

Windows PowerShell:

irm https://dbmcp.haymon.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://dbmcp.haymon.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Consulta la documentación de instalación para Docker, Cargo y otros métodos.

Inicio rápido 🚀

Usando `.mcp.json` (recomendado)

Añade un archivo .mcp.json a la raíz de tu proyecto. Los clientes MCP leen este archivo y configuran el servidor automáticamente.

Transporte stdio — el cliente inicia y gestiona el proceso del servidor:

{
  "mcpServers": {
    "dbmcp": {
      "command": "dbmcp",
      "args": ["stdio"],
      "env": {
        "DB_BACKEND": "mysql",
        "DB_HOST": "127.0.0.1",
        "DB_PORT": "3306",
        "DB_USER": "root",
        "DB_PASSWORD": "secret",
        "DB_NAME": "mydb"
      }
    }
  }
}

Transporte HTTP — tú inicias el servidor y el cliente se conecta a él:

# Start the server first
dbmcp http --db-backend mysql --db-user root --db-name mydb --port 9001

{
  "mcpServers": {
    "dbmcp": {
      "type": "http",
      "url": "http://127.0.0.1:9001/mcp"
    }
  }
}

Nota: El campo "type": "http" es obligatorio para el transporte HTTP. Sin él, clientes como Claude Code rechazarán la configuración.

Usando banderas de CLI

# MySQL/MariaDB
dbmcp stdio --db-backend mysql --db-host localhost --db-user root --db-name mydb

# PostgreSQL
dbmcp stdio --db-backend postgres --db-host localhost --db-user postgres --db-name mydb

# SQLite
dbmcp stdio --db-backend sqlite --db-name ./data.db

# HTTP transport
dbmcp http --db-backend mysql --db-user root --db-name mydb --host 0.0.0.0 --port 9001

Usando variables de entorno

DB_BACKEND=mysql DB_USER=root DB_NAME=mydb dbmcp stdio

Configuración ⚙️

La configuración se carga con una precedencia clara:

Banderas de CLI > variables de entorno > valores predeterminados

Las variables de entorno normalmente las establece tu cliente MCP (mediante env o envFile en la configuración del servidor).

Subcomandos

Subcomando	Descripción
`stdio`	Ejecutar en modo stdio
`http`	Ejecutar en modo HTTP/SSE
`version`	Mostrar información de versión y salir

Se requiere un subcomando: ejecutar dbmcp sin subcomando muestra la ayuda de uso y sale con un estado distinto de cero.

Opciones de base de datos (compartidas entre subcomandos)

Bandera	Variable de entorno	Predeterminado	Descripción
`--db-backend`	`DB_BACKEND`	(obligatorio)	`mysql`, `mariadb`, `postgres` o `sqlite`
`--db-host`	`DB_HOST`	`localhost`	Host de la base de datos
`--db-port`	`DB_PORT`	predeterminado del backend	`3306` (MySQL/MariaDB), `5432` (PostgreSQL)
`--db-user`	`DB_USER`	predeterminado del backend	`root` (MySQL/MariaDB), `postgres` (PostgreSQL)
`--db-password`	`DB_PASSWORD`	(vacío)	Contraseña de la base de datos
`--db-name`	`DB_NAME`	(vacío)	Nombre de la base de datos o ruta del archivo SQLite
`--db-charset`	`DB_CHARSET`		Conjunto de caracteres (solo MySQL/MariaDB)

Opciones SSL/TLS

Bandera	Variable de entorno	Predeterminado	Descripción
`--db-ssl`	`DB_SSL`	`false`	Habilitar SSL
`--db-ssl-ca`	`DB_SSL_CA`		Ruta del certificado CA
`--db-ssl-cert`	`DB_SSL_CERT`		Ruta del certificado de cliente
`--db-ssl-key`	`DB_SSL_KEY`		Ruta de la clave de cliente
`--db-ssl-verify-cert`	`DB_SSL_VERIFY_CERT`	`true`	Verificar el certificado del servidor

Opciones del servidor

Bandera	Variable de entorno	Predeterminado	Descripción
`--db-read-only`	`DB_READ_ONLY`	`true`	Bloquear consultas de escritura
`--db-max-pool-size`	`DB_MAX_POOL_SIZE`	`5`	Tamaño máximo del grupo de conexiones (mín.: 1)
`--db-connection-timeout`	`DB_CONNECTION_TIMEOUT`	(sin definir)	Tiempo de espera de conexión en segundos (mín.: 1)
`--db-query-timeout`	`DB_QUERY_TIMEOUT`	`30`	Tiempo de espera de ejecución de consultas en segundos
`--db-page-size`	`DB_PAGE_SIZE`	`100`	Máximo de elementos por respuesta de herramienta paginada (rango 1–500)

Opciones de registro

Bandera	Variable de entorno	Predeterminado	Descripción
`--log-level`	`LOG_LEVEL`	`info`	Nivel de registro (trace/debug/info/warn/error)

Opciones solo HTTP (disponibles únicamente con el subcomando `http`)

Bandera	Predeterminado	Descripción
`--host`	`127.0.0.1`	Host de enlace
`--port`	`9001`	Puerto de enlace
`--allowed-origins`	variantes de localhost	Orígenes de navegador permitidos (separados por comas). Controla tanto la preflight CORS como el rechazo de Origin en el servidor.
`--allowed-hosts`	`localhost,127.0.0.1,::1`	Cabeceras Host de confianza (separadas por comas). Se aplican en el servidor; se respeta `:authority` de HTTP/2.

Herramientas MCP 🧩

listDatabases

Lista las bases de datos accesibles, paginadas mediante cursor / nextCursor. Consulta Paginación por cursor para conocer los detalles de iteración. No disponible para SQLite.

listTables

Lista las tablas de una base de datos, paginadas mediante cursor / nextCursor. Consulta Paginación por cursor para conocer los detalles de iteración.

Parámetros: database (usa la base de datos activa por defecto; SQLite no tiene parámetro database), cursor, search, detailed.

search es un patrón LIKE/ILIKE opcional que no distingue entre mayúsculas y minúsculas, con % (cualquier secuencia) y _ (un solo carácter) como comodines: pasa users% para coincidir con nombres que empiecen por users, o %order% para coincidencias de subcadena. Una palabra sin comodines solo coincide con un nombre de tabla exacto.