mariadb-mcp-server

简介

MariaDB MCP Server 是一个允许从 MariaDB 数据库获取数据的服务实现，提供只读访问功能。

安装依赖

MariaDB 连接器设置

在 macOS 上，您可能需要安装 MariaDB 连接器:

# 安装 MariaDB 连接器
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

# 安装 Python 驱动
uv add mariadb

配置 Claude Desktop

1. 找到配置文件:

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

2. 添加 MCP Server 配置:

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

注意：请替换所有占位符为实际值

功能

• 资源：访问数据库中的模式列表
• 工具：通过 query_database 工具执行只读 SQL 查询

许可证

此项目使用 MIT 许可证。详见仓库中的 LICENSE 文件。