superset-mcp

Servidor MCP (Model Context Protocol) para Apache Superset. Proporciona a los asistentes de IA acceso completo a tu instancia de Superset: paneles, gráficos, conjuntos de datos, bases de datos y ejecución de SQL.

Requisitos previos

uv — Gestor de paquetes de Python
Acceso a una instancia de Apache Superset en ejecución

Configuración (toma ~1 minuto)

1. Clonar el repositorio

git clone <repo-url>
cd superset-mcp

2. Configurar las credenciales

cp .env.example .env

Edita .env:

SUPERSET_URL=http://your-superset-host:8088
SUPERSET_USERNAME=your-username
SUPERSET_PASSWORD=your-password

3. Probar que funciona

uv run superset-mcp

Deberías ver que el servidor MCP se inicia sin errores. Presiona Ctrl+C para detenerlo.

Conectar a tu cliente de IA

Reemplaza /ABSOLUTE/PATH/TO/superset-mcp con la ruta real donde clonaste el repositorio.

Claude Code

Añade a ~/.claude/settings.json (o al archivo .claude/settings.json a nivel de proyecto):

{
  "mcpServers": {
    "superset": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/superset-mcp", "run", "superset-mcp"],
      "env": {
        "SUPERSET_URL": "http://your-superset-host:8088",
        "SUPERSET_USERNAME": "your-username",
        "SUPERSET_PASSWORD": "your-password"
      }
    }
  }
}

O ejecuta en la terminal:

claude mcp add superset -- uv --directory /ABSOLUTE/PATH/TO/superset-mcp run superset-mcp

Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "superset": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/superset-mcp", "run", "superset-mcp"],
      "env": {
        "SUPERSET_URL": "http://your-superset-host:8088",
        "SUPERSET_USERNAME": "your-username",
        "SUPERSET_PASSWORD": "your-password"
      }
    }
  }
}

Cursor

Añade a .cursor/mcp.json en tu proyecto o a ~/.cursor/mcp.json de forma global:

{
  "mcpServers": {
    "superset": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/superset-mcp", "run", "superset-mcp"],
      "env": {
        "SUPERSET_URL": "http://your-superset-host:8088",
        "SUPERSET_USERNAME": "your-username",
        "SUPERSET_PASSWORD": "your-password"
      }
    }
  }
}

Herramientas disponibles

Paneles (Dashboards)

Herramienta	Descripción
`list_dashboards`	Listar todos los paneles (con búsqueda opcional)
`get_dashboard`	Obtener un panel por ID o slug
`get_dashboard_charts`	Obtener todos los gráficos de un panel
`get_dashboard_datasets`	Obtener todos los conjuntos de datos usados por un panel
`create_dashboard`	Crear un nuevo panel
`update_dashboard`	Actualizar título, diseño, metadatos
`publish_dashboard`	Publicar un panel en borrador
`copy_dashboard`	Duplicar un panel
`delete_dashboard`	Eliminar un panel

Gráficos (Charts)

Herramienta	Descripción
`list_charts`	Listar todos los gráficos (con búsqueda opcional)
`get_chart`	Obtener un gráfico por ID o UUID
`get_chart_data`	Obtener los datos más recientes de un gráfico
`create_chart`	Crear un nuevo gráfico
`update_chart`	Actualizar propiedades del gráfico
`delete_chart`	Eliminar un gráfico

Conjuntos de datos (Datasets)

Herramienta	Descripción
`list_datasets`	Listar todos los conjuntos de datos
`get_dataset`	Obtener un conjunto de datos por ID o UUID
`create_dataset`	Crear a partir de una tabla o consulta SQL
`get_or_create_dataset`	Obtener uno existente o crear uno nuevo
`refresh_dataset`	Sincronizar columnas desde la tabla de origen
`update_dataset`	Actualizar propiedades del conjunto de datos
`get_dataset_related_objects`	Ver qué gráficos/paneles lo utilizan
`delete_dataset`	Eliminar un conjunto de datos

Bases de datos (Databases)

Herramienta	Descripción
`list_databases`	Listar todas las conexiones a bases de datos
`get_database`	Obtener una conexión a base de datos por ID
`list_schemas`	Listar esquemas en una base de datos
`list_tables`	Listar tablas en un esquema
`get_table_metadata`	Obtener información de columnas de una tabla
`get_select_star`	Obtener una plantilla SELECT * para una tabla

SQL

Herramienta	Descripción
`execute_sql`	Ejecutar una consulta SQL y obtener resultados
`format_sql`	Formatear una consulta SQL
`estimate_query_cost`	Estimar el costo de la consulta (si es compatible)
`list_saved_queries`	Listar consultas SQL guardadas
`save_query`	Guardar una consulta SQL

Ejemplos de prompts

Una vez conectado a tu asistente de IA:

"List all published dashboards"
"Create a new dashboard called 'Sales Overview'"
"Show me all charts in dashboard 11"
"Run a SQL query on database 2: SELECT count() FROM orders"*
"What datasets are used by the 'Revenue' dashboard?"
"Create a bar chart using dataset 5 showing sales by region"

Install Server

A

security – no known vulnerabilities

F

license - not found

B

quality - B tier

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

superset-mcp

superset-mcp

Requisitos previos

Configuración (toma ~1 minuto)

1. Clonar el repositorio

2. Configurar las credenciales

3. Probar que funciona

Conectar a tu cliente de IA

Claude Code

Claude Desktop

Cursor

Herramientas disponibles

Paneles (Dashboards)

Gráficos (Charts)

Conjuntos de datos (Datasets)

Bases de datos (Databases)

SQL

Ejemplos de prompts

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API