Servidor MCP de Metabase

Este proyecto implementa un servidor MCP para interactuar con la API de Metabase, exponiendo funcionalidades clave a través de una interfaz MCP.

Características

🔍 Listar tarjetas de Metabase
🗄️ Listar bases de datos disponibles
📊 Ejecutar consultas en tarjetas
🧾 Ejecutar consultas arbitrarias
📝 Crear nuevas tarjetas
🔖 Crear marcadores
📁 Listar colecciones

Requisitos

Python 3.12+
uv

Instalación

Clonar el repositorio:

git clone https://github.com/cuenca-mx/metabase-mcp-server.git
cd metabase-mcp-server

Configurar el cliente de asistente de IA (Claude, Cursor, etc.) añadiendo la siguiente configuración:

{
    "mcpServers": {
        "metabase": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/metabase_mcp_server",
                "run",
                "app.py"
            ],
            "env": {
                "METABASE_URL": "https://metabase.domain.com/",
                "METABASE_API_KEY": "your-secret-api-key"
            }
        }
    }
}

Configuración de Desarrollo

Este proyecto utiliza un Makefile para simplificar las tareas de desarrollo:

make install

Variables de Entorno

Configura las variables de entorno requeridas:

export $(<env.template)

Ejecutar Pruebas

El proyecto utiliza pytest para pruebas unitarias:

uv run pytest

Depuración con MCP Inspector

Utiliza el MCP Inspector para pruebas y depuración:

make dev

Metabase MCP Server

Documentación