Metabase MCP Server

Interaja com o Metabase, a plataforma de inteligência de negócios de código aberto, usando Modelos de Linguagem de Grande Escala.

Documentação

Metabase MCP Server

Este projeto implementa um servidor MCP para interagir com a Metabase API, expondo funcionalidades principais por meio de uma interface MCP.

Recursos

  • 🔍 Listar cards do Metabase
  • 🗄️ Listar bancos de dados disponíveis
  • 📊 Executar consultas em cards
  • 🧾 Executar consultas arbitrárias
  • 📝 Criar novos cards
  • 🔖 Criar marcador
  • 📁 Listar coleções

Requisitos

  • Python 3.12+
  • uv

Instalação

  1. Clone o repositório:
git clone https://github.com/cuenca-mx/metabase-mcp-server.git
cd metabase-mcp-server
  1. Configure seu cliente de assistente de IA (Claude, Cursor, etc.) adicionando a seguinte configuração:
{
    "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"
            }
        }
    }
}

Configuração de Desenvolvimento

Este projeto usa um Makefile para simplificar tarefas de desenvolvimento:

make install

Variáveis de Ambiente

Configure as variáveis de ambiente necessárias:

export $(<env.template)

Executando Testes

O projeto usa pytest para testes unitários:

uv run pytest

Depuração com o MCP Inspector

Use o MCP Inspector para testar e depurar:

make dev