mcp-server-mariadb

用于从MariaDB检索数据的MCP服务器实现。

特性

资源

在数据库中暴露模式列表。

工具

• query_database
  • 对MariDB执行只读操作。

依赖

安装MariaDB

• macOS
  • 在安装MariaDB时， 可能会出现以下操作系统错误。 可以通过安装mariadb-connector-c来解决。

OSError: 未找到mariadb_config。

      这个错误通常表示MariaDB Connector/C，一个必须预先安装的依赖项，
      没有被找到。
      如果没有安装MariaDB Connector/C，请查看安装说明。
      如果已经安装了MariaDB Connector/C，请设置环境变量MARIADB_CONFIG，
      或者编辑配置文件'site.cfg'，将'mariadb_config'选项设置为mariadb_config工具的位置。

1. 执行 brew install mariadb-connector-c
2. 执行 echo 'export PATH="/opt/homebrew/opt/mariadb-connector-c/bin:$PATH"' >> ~/.bashrc
3. 设置环境变量 export MARIADB_CONFIG=$(brew --prefix mariadb-connector-c)/bin/mariadb_config
4. 再次执行 uv add mariadb。

使用与Claude Desktop

配置文件

Claude Desktop配置文件路径：

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

<!-- markdownlint-disable MD033 --> <details> <summary>添加此配置以启用已发布的服务器</summary>

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

注意：用实际路径替换这些占位符：

• /PATH/TO/uvx: uvx可执行文件的完整路径

</details> <details> <summary>添加此配置以启用开发/未发布的服务器</summary>

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

注意：用实际路径替换这些占位符：

• /PATH/TO/uv: UV可执行文件的完整路径
• /YOUR/SOURCE/PATH/mcp-server-mariadb/src/mcp_server_mariadb: 服务器源代码路径

</details>

许可证

此MCP服务器采用MIT许可证。请参阅存储库中的LICENSE文件。