mariadb-mcp MCP Server

The MCP MariaDB Server provides a Model Context Protocol (MCP) interface for managing and querying MariaDB databases, supporting both standard SQL operations and advanced vector/embedding-based…

Local serverstdio

What is the mariadb-mcp Server?

mariadb-mcp is an MCP project maintained in the mariadb/mcp repository. The maintainer describes its purpose as “The MCP MariaDB Server provides a Model Context Protocol (MCP) interface for managing and querying MariaDB databases, supporting both standard SQL operations and advanced vector/embedding-based…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using uv. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

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_databasesLists all accessible databases.
Parametersdatabase_name, vector_store_name, user_query (string), k (optional, default: 7)
list_tablesLists all tables in a specified database.
get_table_schemaRetrieves schema for a table (columns, types, keys, etc.).
get_table_schema_with_relationsRetrieves schema with foreign key relations for a table.
execute_sqlExecutes a read-only SQL query (SELECT, SHOW, DESCRIBE).
create_databaseCreates a new database if it doesn't exist.
create_vector_storeCreates a new vector store (table) for embeddings.
delete_vector_storeDeletes a vector store (table).
list_vector_storesLists all vector stores in a database.
insert_docs_vector_storeBatch inserts documents (and optional metadata) into a vector store.
search_vector_storePerforms semantic search for similar documents using embeddings.

How to install the mariadb-mcp Server

{
  "mcpServers": {
    "MariaDB_Server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/mariadb-mcp-server/",
        "run",
        "server.py"
      ],
      "envFile": "path/to/mcp-server-mariadb-vector/.env"
    }
  }
}

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