mariadb-mcp-server MCP Server

This MCP server exposes MariaDB and MySQL databases to MCP clients such as Claude Desktop, VS Code, and other compatible tools.

Local serverstdioMIT

What is the mariadb-mcp-server MCP Server?

mariadb-mcp-server is an MCP project maintained in the rjsalgado/mariadb-mcp-server repository. The maintainer describes its purpose as “This MCP server exposes MariaDB and MySQL databases to MCP clients such as Claude Desktop, VS Code, and other compatible tools”. Read the project documentation for the complete scope.

Installation

The documented npm package is mariadb-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares MARIADB_HOST, MARIADB_PORT, MARIADB_USER, MARIADB_PASSWORD, MARIADB_DATABASE, MARIADB_ALLOW_INSERT, MARIADB_ALLOW_UPDATE, MARIADB_ALLOW_DELETE, MARIADB_TIMEOUT_MS, MARIADB_ROW_LIMIT. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_databases
list_tables
describe_table
execute_query

How to install the mariadb-mcp-server MCP Server

{
  "mcpServers": {
    "mariadb": {
      "command": "npx",
      "args": [
        "mariadb-mcp-server"
      ],
      "env": {
        "MARIADB_HOST": "your-host",
        "MARIADB_PORT": "3306",
        "MARIADB_USER": "your-user",
        "MARIADB_PASSWORD": "YOUR_MARIADB_PASSWORD",
        "MARIADB_DATABASE": "your-database",
        "MARIADB_ALLOW_INSERT": "false",
        "MARIADB_ALLOW_UPDATE": "false",
        "MARIADB_ALLOW_DELETE": "false",
        "MARIADB_TIMEOUT_MS": "10000",
        "MARIADB_ROW_LIMIT": "1000"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
MARIADB_HOSTDeclared in the maintainer’s client configuration.Check documentation
MARIADB_PORTDeclared in the maintainer’s client configuration.Check documentation
MARIADB_USERDeclared in the maintainer’s client configuration.Check documentation
MARIADB_PASSWORDDeclared in the maintainer’s client configuration.Check documentation
MARIADB_DATABASEDeclared in the maintainer’s client configuration.Optional
MARIADB_ALLOW_INSERTDeclared in the maintainer’s client configuration.Check documentation
MARIADB_ALLOW_UPDATEDeclared in the maintainer’s client configuration.Check documentation
MARIADB_ALLOW_DELETEDeclared in the maintainer’s client configuration.Check documentation
MARIADB_TIMEOUT_MSDeclared in the maintainer’s client configuration.Check documentation
MARIADB_ROW_LIMITDeclared in the maintainer’s client configuration.Check documentation