Skip to main content
Glama
MariaDB MCP Server

MariaDB MCP Server

by bretoreta

Servidor MCP de acceso a bases de datos MariaDB/MySQL

Este servidor MCP proporciona acceso a bases de datos MariaDB / MySQL.

Permite:

  • Lista de bases de datos disponibles

  • Listar tablas en una base de datos

  • Describir esquemas de tablas

  • Ejecutar consultas SQL

Características de seguridad

  • Acceso de solo lectura. Predeterminado : SELECCIONAR, MOSTRAR, DESCRIBIR y EXPLICAR.

  • Validación de consultas : evita la inyección de SQL y bloquea cualquier intento de modificación de datos

  • Tiempo de espera de consulta : evita que las consultas de larga duración consuman recursos

  • Límite de filas : evita la devolución excesiva de datos

Related MCP server: MySQL MCP Server

Instalación

Opción 1: Construir desde la fuente

# Clone the repository
git clone https://github.com/bretoreta/mariadb-mcp-server.git
cd mariadb-mcp-server

# Install dependencies and build
pnpm install
pnpm run build

2. Configurar variables de entorno

El servidor requiere las siguientes variables de entorno:

  • MARIADB_HOST: Nombre de host del servidor de base de datos

  • MARIADB_PORT: Puerto del servidor de base de datos (predeterminado: 3306)

  • MARIADB_USER: Nombre de usuario de la base de datos

  • MARIADB_PASSWORD: Contraseña de la base de datos

  • MARIADB_DATABASE: Nombre de la base de datos predeterminada (opcional)

  • MARIADB_ALLOW_INSERT: falso

  • MARIADB_ALLOW_UPDATE: falso

  • MARIADB_ALLOW_DELETE: falso

  • TIEMPO DE ESPERA DE MARIADB: 10000 ms

  • LÍMITE DE FILAS DE MARIADB: 1000

3. Agregar a la configuración de MCP

Agregue la siguiente configuración a su archivo de configuración de MCP:

Si lo construiste desde la fuente:

{
  "mcpServers": {
    "mariadb": {
      "command": "node",
      "args": ["/path/to/mariadb-mcp-server/dist/index.js"],
      "env": {
        "MARIADB_HOST": "your-host",
        "MARIADB_PORT": "3306",
        "MARIADB_USER": "your-user",
        "MARIADB_PASSWORD": "your-password",
        "MARIADB_DATABASE": "your-default-database",
        "MARIADB_ALLOW_INSERT": "false",
        "MARIADB_ALLOW_UPDATE": "false",
        "MARIADB_ALLOW_DELETE": "false",
        "MARIADB_TIMEOUT_MS": "10000",
        "MARIADB_ROW_LIMIT": "1000",
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Herramientas disponibles

lista_bases_de_datos

Enumera todas las bases de datos accesibles en el servidor MariaDB/MySQL. Parámetros : Ninguno.

Ejemplo :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "sessionId": "session_id from /sse call",
    "name": "list_databases"
  }
}

listas_de_tablas

Enumera todas las tablas de una base de datos especificada.

Parámetros :

  • database (opcional): nombre de la base de datos (usa el predeterminado si no se especifica)

Ejemplo :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "sessionId": "session_id from /sse call",
    "name": "list_tables",
    "database": "my_database_name"
  }
}

describe_tabla

Muestra el esquema de una tabla específica.

Parámetros :

  • database (opcional): nombre de la base de datos (usa el predeterminado si no se especifica)

  • table (obligatorio): Nombre de la tabla

Ejemplo :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "sessionId": "session_id from /sse call",
    "name": "describe_table",
    "database": "my_database_name",
    "table": "my_table_name"
  }
}

ejecutar_consulta

Ejecuta una consulta SQL.

Parámetros :

  • query (obligatoria): consulta SQL

  • database (opcional): nombre de la base de datos (usa el predeterminado si no se especifica)

Ejemplo :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "sessionId": "session_id from /sse call",
    "name": "execute_query",
    "query": "SELECT * FROM my_table LIMIT 10"
  }
}

Pruebas

El servidor prueba automáticamente MariaDB para verificar la funcionalidad con su configuración de MariaDB:

Solución de problemas

Si encuentra problemas:

  1. Verifique los registros del servidor para ver si hay mensajes de error

  2. Verifique sus credenciales de MariaDB y los detalles de conexión

  3. Asegúrese de que su usuario de MariaDB tenga los permisos adecuados

  4. Compruebe que su consulta sea de solo lectura y tenga el formato correcto

Inspiración https://github.com/rjsalgado/mariadb-mcp-server

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Available Tools

4 tools
describe_tableB

Show the schema for a specific table

Inputs: table (required), database.

execute_queryC

Execute a SQL query

Inputs: query (required), database.

list_databasesB

List all accessible databases on the MariaDB server

Inputs: no named parameters.

list_tablesC

List all tables in a specified database

Inputs: database.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: describe_table shows table schemas, execute_query runs SQL queries, list_databases enumerates databases, and list_tables lists tables within a database. The boundaries are well-defined, preventing agent misselection.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (describe_table, execute_query, list_databases, list_tables) with clear, descriptive verbs. There are no deviations in style or convention, making the set predictable and readable.

    Tool Count4/5

    Four tools is reasonable for a MariaDB server, covering core operations like listing databases/tables, describing schemas, and executing queries. It feels slightly thin as it lacks CRUD operations (e.g., create_table, insert_data), but it's well-scoped for basic database inspection and query execution.

    Completeness3/5

    The tools provide good coverage for database inspection and query execution, but there are notable gaps in CRUD operations (e.g., no create_table, update_data, or delete_table). Agents can work around this using execute_query, but the surface is incomplete for full database management workflows.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables interaction with MariaDB databases through secure read-only operations. Supports database exploration, schema inspection, and SQL query execution with comprehensive logging and connection pooling.
      5
      2
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables safe interaction with MySQL databases through SELECT queries, table structure inspection, and database schema exploration. Provides read-only access to query data and examine database metadata.
      1
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables read-only MySQL database access, allowing listing databases, tables, describing schemas, and executing SELECT/SHOW/DESCRIBE/EXPLAIN queries.
      7
      30 npm
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides read-only MySQL query execution, database/table browsing, and table structure inspection with SQL safety validation.
      5
      9 npm
      MIT