mcp-server-mariadb

基本能力

产品定位

mcp-server-mariadb 是一个数据库连接服务，专门用于与 MariaDB 数据库进行交互。

核心功能

1. 资源暴露：可以暴露数据库中的模式列表。
2. 工具能力：
3. query_database：执行对 MariaDB 的只读操作。

适用场景

1. 需要从 MariaDB 数据库中检索数据的应用场景。
2. 需要暴露数据库模式列表的开发场景。

使用教程

使用依赖

在 Mac 上安装 mariadb-connector-c：

brew install mariadb-connector-c
echo 'export PATH="/opt/homebrew/opt/mariadb-connector-c/bin:$PATH"' >> ~/.bashrc
export MARIADB_CONFIG=$(brew --prefix mariadb-connector-c)/bin/mariadb_config
uv add mariadb

安装教程

1. 配置 Claude Desktop 的配置文件：
2. MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

3. Windows: %APPDATA%\Claude\claude_desktop_config.json

4. 添加以下配置以启用发布的服务器：

{
    "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}"
            ]
        }
    }
}

1. 或者添加以下配置以启用开发/未发布的服务器：

{
    "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"
            }
        }
    }
}

调试方式

安装完成后，可以通过检查配置文件是否正确设置来进行调试。确保所有路径和环境变量都已正确配置。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。