mariadb.com
mariadb.com logo

MariaDB

Bridges Claude with MariaDB databases for read-only SQL query execution, enabling data exploration through formatted tab...

Created byApr 23, 2025

mcp-server-mariadb

An MCP server implementation for retrieving data from mariadb

Features

Resources

Expose schema list in database

Tools

  • query_database - Execute read-only operations against MariDB

dependency

install mariadb

  • mac - when install mariadb, maybe raise os error below. you can resolve by installing mariadb-connector-c.
  1. execute `brew install mariadb-connector-c`
  1. execute `echo 'export PATH="/opt/homebrew/opt/mariadb-connector-c/bin:$PATH"' >> ~/.bashrc`
  1. set environment variable `export MARIADB_CONFIG=$(brew --prefix mariadb-connector-c)/bin/mariadb_config`
  1. execute `uv add mariadb` again.

Usage with Claude Desktop

Configuration File

Paths to Claude Desktop config file:
  • **MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
  • **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
**Note**: Replace these placeholders with actual paths:
  • `/PATH/TO/uvx`: Full path to uvx executable
**Note**: Replace these placeholders with actual paths:
  • `/PATH/TO/uv`: Full path to UV executable
  • `/YOUR/SOURCE/PATH/mcp-server-mariadb/src/mcp_server_mariadb`: Path to server source code

License

This mcp server is licensed under the MIT license. please see the LICENSE file in the repository.