mcp-server-mariadb

An MCP server implementation for retrieving data from MariaDB databases.

Features

Resources

Exposes the schema list within the database.

Tools

• query_database: Executes read-only queries against the MariaDB database.

Dependency

Install MariaDB Connector/C

On macOS, an OSError related to mariadb_config might occur during installation. This can be resolved by installing MariaDB Connector/C using brew install mariadb-connector-c. Subsequently, update the PATH environment variable, set the MARIADB_CONFIG environment variable, and retry uv add mariadb.

Usage with Claude Desktop

Configuration File

Configuration files for Claude Desktop are located at ~/Library/Application Support/Claude/claude_desktop_config.json (MacOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).

Two configuration examples are provided: one for published servers, using the uvx executable and environment variables for database credentials, and another for development/unpublished servers, using the uv executable, specifying the server source code directory, and setting database connection details via environment variables.

License

This MCP server is licensed under the MIT license. Refer to the LICENSE file in the repository for details.