Servidor MCP de Metabase

Un servidor del Protocolo de Contexto de Modelo (MCP) que integra asistentes de IA con la plataforma de análisis Metabase.

Descripción general

Este servidor MCP proporciona integración con la API de Metabase, permitiendo que los LLM con capacidades MCP interactúen directamente con sus datos analíticos; este servidor actúa como un puente entre su plataforma de análisis y la IA conversacional.

Características clave

• Acceso a recursos: Navegue por los recursos de Metabase a través de URIs intuitivas metabase://

• Dos métodos de autenticación: Soporte tanto para autenticación basada en sesión como mediante clave API

• Acceso a datos estructurados: Respuestas en formato JSON para un fácil consumo por parte de los asistentes de IA

• Registro completo: Registro detallado para facilitar la depuración y el monitoreo

• Manejo de errores: Manejo robusto de errores con mensajes claros

Related MCP server: Metabase MCP Server

Herramientas disponibles

El servidor expone las siguientes herramientas para los asistentes de IA:

Herramientas de acceso a datos

• list_dashboards: Recupera todos los paneles disponibles en su instancia de Metabase

• list_cards: Obtiene todas las preguntas/tarjetas guardadas en Metabase

• list_databases: Ve todas las fuentes de bases de datos conectadas

• list_collections: Enumera todas las colecciones en Metabase

• list_tables: Enumera todas las tablas en una base de datos específica

• get_table_fields: Obtiene todos los campos/columnas en una tabla específica

Herramientas de ejecución

• execute_card: Ejecuta preguntas guardadas y recupera resultados con parámetros opcionales

• execute_query: Ejecuta consultas SQL personalizadas contra cualquier base de datos conectada

Gestión de paneles

• get_dashboard_cards: Extrae todas las tarjetas de un panel específico

• create_dashboard: Crea un nuevo panel con el nombre y los parámetros especificados

• update_dashboard: Actualiza el nombre, la descripción o los parámetros de un panel existente

• delete_dashboard: Elimina un panel

• add_card_to_dashboard: Agrega o actualiza tarjetas en un panel con especificaciones de posición y asignación de pestañas opcional

Gestión de tarjetas/preguntas

• create_card: Crea una nueva pregunta/tarjeta con una consulta SQL

• update_card_visualization: Actualiza la configuración de visualización de una tarjeta

Gestión de colecciones

• create_collection: Crea una nueva colección para organizar paneles y preguntas

Configuración

El servidor admite dos métodos de autenticación:

Opción 1: Autenticación con nombre de usuario y contraseña

# Required
METABASE_URL=https://your-metabase-instance.com
METABASE_USER_EMAIL=your_email@example.com
METABASE_PASSWORD=your_password

# Optional
LOG_LEVEL=info # Options: debug, info, warn, error, fatal

Opción 2: Autenticación con clave API (Recomendado para producción)

# Required
METABASE_URL=https://your-metabase-instance.com
METABASE_API_KEY=your_api_key

# Optional
LOG_LEVEL=info # Options: debug, info, warn, error, fatal

Puede establecer estas variables de entorno directamente o usar un archivo .env con dotenv.

Implementación con Smithery

Para usar este servidor MCP con Claude u otros asistentes de IA, bifurque este repositorio e impleméntelo usando Smithery:

Pasos para implementar:

1. Bifurque este repositorio en su cuenta de GitHub

2. Vaya a Smithery y conéctese con su cuenta de GitHub

3. Implemente el repositorio bifurcado a través de la interfaz de Smithery

Integración con Claude Desktop

Configure su Claude Desktop para usar la versión alojada en Smithery:

MacOS: Edite ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: Edite %APPDATA%/Claude/claude_desktop_config.json

Autenticación con clave API:

{
  "mcpServers": {
    "metabase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "YOUR_GITHUB_USERNAME/metabase-mcp-server",
        "--config",
        "{\"metabaseUrl\":\"https://your-metabase-instance.com\",\"metabaseApiKey\":\"your_api_key\",\"metabasePassword\":\"\",\"metabaseUserEmail\":\"\"}"
      ]
    }
  }
}

Autenticación con nombre de usuario y contraseña:

{
  "mcpServers": {
    "metabase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "YOUR_GITHUB_USERNAME/metabase-mcp-server",
        "--config",
        "{\"metabaseUrl\":\"https://your-metabase-instance.com\",\"metabaseApiKey\":\"\",\"metabasePassword\":\"your_password\",\"metabaseUserEmail\":\"your_email@example.com\"}"
      ]
    }
  }
}

Consideraciones de seguridad

• Se recomienda usar la autenticación con clave API para entornos de producción

• Mantenga sus claves API y credenciales seguras

• Considere usar variables de entorno en lugar de codificar las credenciales

• Aplique medidas de seguridad de red adecuadas para restringir el acceso a su instancia de Metabase

Contribuciones

¡Las contribuciones son bienvenidas! Por favor, siéntase libre de enviar una solicitud de extracción (Pull Request).