An mcp server that provides read-only access to MariaDB.

Listed September 17, 2026

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.


OSError: mariadb_config not found.

      This error typically indicates that MariaDB Connector/C, a dependency which
      must be preinstalled, is not found.
      If MariaDB Connector/C is not installed, see installation instructions
      If MariaDB Connector/C is installed, either set the environment variable
      MARIADB_CONFIG or edit the configuration file 'site.cfg' to set the
       'mariadb_config' option to the file location of the mariadb_config utility.

execute brew install mariadb-connector-c
execute echo 'export PATH="/opt/homebrew/opt/mariadb-connector-c/bin:$PATH"' >> ~/.bashrc
set environment variable export MARIADB_CONFIG=$(brew --prefix mariadb-connector-c)/bin/mariadb_config
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

Add this configuration to enable published servers


{
    "mcpServers": {
        "mcp_server_mariadb": {
            "command": "/PATH/TO/uvx"
            "args": [
                "mcp-server-mariadb",
                "--host",
                "${DB_HOST}",
                "--port",
                "${DB_PORT}",
                "--user",
                "${DB_USER}",
                "--password",
                "${DB_PASSWORD}",
                "--database",
                "${DB_NAME}"
            ]
        }
    }
}

Note: Replace these placeholders with actual paths:

/PATH/TO/uvx: Full path to uvx executable

Add this configuration to enable development/unpublished servers

{
    "mcpServers": {
        "mcp_server_mariadb": {
            "command": "/PATH/TO/uv",
            "args": [
                "--directory",
                "/YOUR/SOURCE/PATH/mcp-server-mariadb/src/mcp_server_mariadb",
                "run",
                "server.py"
            ],
            "env": {
                "MARIADB_HOST": "127.0.0.1",
                "MARIADB_USER": "USER",
                "MARIADB_PASSWORD": "PASSWORD",
                "MARIADB_DATABASE": "DATABASE",
                "MARIADB_PORT": "3306"
            }
        }
    }
}

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.

stdioLocal

Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.

bash

Run the command below in your terminal.
Restart Claude Code, then check the connection with /mcp.

claude mcp add mcp_server_mariadb -- /PATH/TO/uv --directory /YOUR/SOURCE/PATH/mcp-server-mariadb/src/mcp_server_mariadb run server.py

{
  "mcpServers": {
    "mcp_server_mariadb": {
      "env": {
        "MARIADB_HOST": "",
        "MARIADB_PORT": "",
        "MARIADB_USER": "",
        "MARIADB_DATABASE": "",
        "MARIADB_PASSWORD": ""
      },
      "args": [
        "--directory",
        "/YOUR/SOURCE/PATH/mcp-server-mariadb/src/mcp_server_mariadb",
        "run",
        "server.py"
      ],
      "command": "/PATH/TO/uv"
    }
  }
}

code --add-mcp '{"name":"mcp_server_mariadb","env":{"MARIADB_HOST":"","MARIADB_PORT":"","MARIADB_USER":"","MARIADB_DATABASE":"","MARIADB_PASSWORD":""},"args":["--directory","/YOUR/SOURCE/PATH/mcp-server-mariadb/src/mcp_server_mariadb","run","server.py"],"command":"/PATH/TO/uv"}'

[mcp_servers.mcp_server_mariadb]
command = "/PATH/TO/uv"
args = ["--directory", "/YOUR/SOURCE/PATH/mcp-server-mariadb/src/mcp_server_mariadb", "run", "server.py"]

Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.

Install with your agent

Paste this prompt into your agent. It reads this page and does the setup for you.

prompt

Read https://aiagentslisting.com/mcp/mcp-server-mariadb to learn what the "Mcp Server Mariadb" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.

Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp

This server runs locally, so we can't read its tool list over the web yet.

Coming soon:Auto tool detectionServer badgesServer score

F45%

45 / 100 pointsGrade F

Required items: 2 / 34 of 9 checks passed

What's missing

Exposes toolsRequiredThe server reports at least one tool, from its manifest or a live read.
0/15
Verified liveWe connected to the server and it answered a real MCP handshake.
0/20
Ships promptsThe server exposes at least one prompt template.
0/8
Ships resourcesThe server exposes at least one resource.
0/8
Claimed by ownerThe maintainer proved ownership of this listing.
0/4

All 9 checks (4 passed)

Installation methodRequiredThe README documents at least one way to install or connect.
15/15
Exposes toolsRequiredThe server reports at least one tool, from its manifest or a live read.
0/15
Has a READMERequiredThe repository ships documentation we could read.
10/10
Verified liveWe connected to the server and it answered a real MCP handshake.
0/20
Easy installA paste-ready client config (an mcpServers block) is documented.
12/12
Has a licenseThe repository declares a license.
8/8
Ships promptsThe server exposes at least one prompt template.
0/8
Ships resourcesThe server exposes at least one resource.
0/8
Claimed by ownerThe maintainer proved ownership of this listing.
0/4

Maintain this server? Claiming proves you own the listing and earns the last 4 points.

Claim this listing

Show this grade in your README

Paste this line near the top of your repository's README. The badge always renders the current score.

markdown

[![Mcp Server Mariadb score on AI Agents Listing](https://aiagentslisting.com/mcp-server-mariadb/badge.svg?variant=score)](https://aiagentslisting.com/mcp/mcp-server-mariadb)

Alternatives to Mcp Server Mariadb

Nothing comparable is listed yet.

v0.1.2Mar 6, 2025Release notes
v0.1.1Feb 23, 2025Release notes
v0.1.0Feb 23, 2025Release notes

Mcp Server Mariadb