MariaDB

mcp-server-mariadb

Una implementación de servidor MCP para recuperar datos de mariadb

Características

Recursos

Exponer la lista de esquemas en la base de datos

Herramientas

• query_database
  • Ejecutar operaciones de solo lectura contra MariDB

Dependencia

Instalar mariadb

• mac
  • Al instalar mariadb, es posible que se produzca el siguiente error de sistema operativo. Puedes resolverlo instalando 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.

1. ejecuta brew install mariadb-connector-c
2. ejecuta echo 'export PATH="/opt/homebrew/opt/mariadb-connector-c/bin:$PATH"' >> ~/.bashrc
3. establece la variable de entorno export MARIADB_CONFIG=$(brew --prefix mariadb-connector-c)/bin/mariadb_config
4. ejecuta uv add mariadb nuevamente.

Uso con Claude Desktop

Archivo de configuración

Rutas al archivo de configuración de Claude Desktop:

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

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

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

Licencia

Este servidor MCP está licenciado bajo la licencia MIT. Consulta el archivo LICENSE en el repositorio.