MariaDB MCP Server

Content

MariaDB MCP Server is the official MariaDB Model Context Protocol server for connecting Claude and other MCP clients to MariaDB databases. It exposes tools for listing databases and tables, inspecting schemas, running read-only SQL, and optionally managing embedding-backed vector stores inside MariaDB.

The server is implemented with FastMCP and asyncmy. It runs from a Python checkout with uv, supports stdio by default, and can also run over SSE or streamable HTTP when operators configure authentication and network controls.

Source Review

• https://github.com/MariaDB/mcp
• https://github.com/MariaDB/mcp#readme
• https://github.com/MariaDB/mcp/blob/main/README.md
• https://github.com/MariaDB/mcp/blob/main/pyproject.toml
• https://github.com/MariaDB/mcp/blob/main/src/server.py
• https://github.com/MariaDB/mcp/blob/main/src/config.py
• https://github.com/MariaDB/mcp/blob/main/LICENSE

These sources were reviewed on 2026-06-06. Prefer the live repository, README, package metadata, server implementation, configuration module, and license for current installation steps, environment variables, tool behavior, transport options, and safety notes.

Features

• Official MariaDB MCP repository under MariaDB/mcp.
• Python 3.11 server managed with uv.
• Stdio transport by default, with optional SSE and streamable HTTP modes.
• Database listing and table listing tools.
• Schema inspection with column metadata and foreign-key relationships.
• execute_sql tool for read-only SQL workflows when MCP_READ_ONLY=true.
• create_database tool for database creation workflows.
• Optional vector-store tools when an embedding provider is configured.
• OpenAI, Gemini, and HuggingFace embedding provider support.
• SSL/TLS environment variables for MariaDB connections.
• Host, origin, log, pool-size, and read-only environment configuration.

Installation

Clone the MariaDB MCP repository, install dependencies with uv, create a reviewed .env, and configure the MCP client to launch the server from that checkout:

{
  "mcpServers": {
    "mariadb": {
      "command": "uv",
      "args": [
        "--directory",
        "<mariadb-mcp-checkout>",
        "run",
        "server.py"
      ],
      "env": {
        "DB_HOST": "<mariadb-host>",
        "DB_PORT": "3306",
        "DB_USER": "<least-privilege-user>",
        "DB_PASSWORD": "<mariadb-password>",
        "DB_NAME": "<approved-database>",
        "MCP_READ_ONLY": "true"
      }
    }
  }
}

Keep MCP_READ_ONLY=true for exploration, and enforce least privilege at the MariaDB user level before connecting important data.

Use Cases

• Ask Claude to list accessible databases before choosing a target.
• Inspect table schemas and foreign-key relationships before writing SQL.
• Run reviewed SELECT queries against development or analytics databases.
• Compare schema shape across MariaDB environments.
• Prototype vector search over approved MariaDB tables.
• Use OpenAI, Gemini, or HuggingFace embeddings for semantic search when that data flow is approved.
• Keep database creation and vector-store mutation workflows behind human review.

Safety and Privacy

MariaDB MCP is a database control surface. Treat every query as executable code, use dedicated least-privilege credentials, and rely on database permissions rather than client-side filters alone. Keep read-only mode enabled by default, review generated SQL before execution, revoke global FILE privileges, and avoid connecting production or regulated datasets unless the MCP client, model session, and operators are approved for that access.

Vector-store features can persist documents, embeddings, and metadata in MariaDB, while external embedding providers may receive document text or derived content. Review provider terms, retention, logging, and data residency before turning those tools on.

Disclosure

MariaDB offers open-source and commercial database products and services. This listing is not sponsored, paid, or affiliate-driven, and it is scoped to the source-backed open repository for the MariaDB MCP server.

Duplicate Check

Existing content includes DBHub, a multi-database MCP server that can connect to MariaDB among other engines. This entry is distinct because it covers MariaDB/mcp, the official MariaDB-specific MCP server. No dedicated MariaDB MCP Server, MariaDB/mcp, or matching source URL entry was found in content/mcp.

• Source repositorygithub.com 2026-07-21T07:17:01+00:00
• Documentationgithub.com
• Submitted by oktofeesh12026-06-06