Mariadb MCP Server

by arifulislamatio.github.arifulislamat/database-mcp-mariadbv0.4.2

MCP server for MariaDB. Read-only by default, row caps, timeouts, secrets never logged.

5Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained3mo ago

Install Mariadb MCP server

claude mcp add mariadb -e MARIADB_HOST='<mariadb-host>' -e MARIADB_USER='<mariadb-user>' -e MARIADB_PASSWORD='<mariadb-password>' -e MARIADB_DATABASE='<mariadb-database>' -- npx -y @database-mcp/mariadb

{
  "mcpServers": {
    "mariadb": {
      "command": "npx",
      "args": [
        "-y",
        "@database-mcp/mariadb"
      ],
      "env": {
        "MARIADB_HOST": "<mariadb-host>",
        "MARIADB_USER": "<mariadb-user>",
        "MARIADB_PASSWORD": "<mariadb-password>",
        "MARIADB_DATABASE": "<mariadb-database>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "mariadb": {
      "command": "npx",
      "args": [
        "-y",
        "@database-mcp/mariadb"
      ],
      "env": {
        "MARIADB_HOST": "<mariadb-host>",
        "MARIADB_USER": "<mariadb-user>",
        "MARIADB_PASSWORD": "<mariadb-password>",
        "MARIADB_DATABASE": "<mariadb-database>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "mariadb": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@database-mcp/mariadb"
      ],
      "env": {
        "MARIADB_HOST": "<mariadb-host>",
        "MARIADB_USER": "<mariadb-user>",
        "MARIADB_PASSWORD": "<mariadb-password>",
        "MARIADB_DATABASE": "<mariadb-database>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "mariadb": {
      "command": "npx",
      "args": [
        "-y",
        "@database-mcp/mariadb"
      ],
      "env": {
        "MARIADB_HOST": "<mariadb-host>",
        "MARIADB_USER": "<mariadb-user>",
        "MARIADB_PASSWORD": "<mariadb-password>",
        "MARIADB_DATABASE": "<mariadb-database>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MARIADB_HOST	yes	—	Database host
MARIADB_USER	yes	—	Database user (a read-only user is recommended)
MARIADB_PASSWORD	—	yes	Database password (or use MARIADB_PASSWORD_FILE)
MARIADB_DATABASE	yes	—	Database name

Freshness

Maintained — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-17 · 3mo ago · GitHub
Latest release
2026-07-16 · 3mo ago · GitHub · postgres-ts-v0.4.2
Package published
no data · npm/PyPI
Registry entry updated
2026-07-16 · 3mo ago · official registry · v0.4.2

FAQ

›How do I install the Mariadb MCP server in Claude Code?

Run: claude mcp add mariadb -e MARIADB_HOST='<mariadb-host>' -e MARIADB_USER='<mariadb-user>' -e MARIADB_PASSWORD='<mariadb-password>' -e MARIADB_DATABASE='<mariadb-database>' -- npx -y @database-mcp/mariadb. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Mariadb require an API key?

Yes. It expects MARIADB_HOST, MARIADB_USER, MARIADB_DATABASE, MARIADB_PASSWORD, of which 1 is a secret.

›Can I use Mariadb as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Mariadb in the official MCP registry?

Yes, as io.github.arifulislamat/database-mcp-mariadb.