Skip to main content
Glama

mcp-superset

PyPI version PyPI downloads Python 3.12+ License: MIT CI CodeQL

Superset 6.0.1 MCP Typed Ruff uv Tools: 137 GitHub stars

Un servidor completo del Protocolo de Contexto de Modelo (MCP) para Apache Superset. Ofrece a los asistentes de IA (Claude, GPT, etc.) control total sobre su instancia de Superset (paneles, gráficos, conjuntos de datos, SQL Lab, usuarios, roles, RLS y más) a través de 137 herramientas.

Comparación con otros servidores MCP de Superset

Característica

mcp-superset

superset-mcp

superset-mcp (Winding2020)

superset-mcp-server

Total de herramientas

137

60

31

4

Lenguaje

Python

Python

TypeScript

TypeScript

CRUD de paneles

15 herramientas

5

8

-

Filtros nativos de panel

5 herramientas

-

-

-

CRUD de gráficos

11 herramientas

5

7

-

Herramientas de base de datos

18 herramientas

14

1

1

Herramientas de conjuntos de datos

11 herramientas

3

7

-

SQL Lab

5 herramientas

7

1

1

Seguridad (usuarios/roles)

26 herramientas

2

-

-

Seguridad a nivel de fila (RLS)

5 herramientas

-

-

-

Grupos

9 herramientas

-

-

-

Auditoría de permisos

-

-

-

Concesión/revocación de acceso a paneles

-

-

-

Sincronización automática de datasource_access

-

-

-

Informes y anotaciones

10 herramientas

-

-

-

Etiquetas

7 herramientas

7

-

-

Exportación/importación de activos

-

-

-

Seguridad: indicadores de confirmación

14 tipos

-

-

-

Seguridad: bloqueo de DDL/DML

-

-

-

Seguridad: protección de roles del sistema

-

-

-

Transporte

HTTP, SSE, stdio

stdio

stdio

stdio

Método de autenticación

JWT + actualización automática + CSRF

Nombre de usuario/contraseña + archivo de token

Nombre de usuario/contraseña o token

LDAP

Versiones de Superset

6.0.1

4.1.1

no especificado

no especificado

CLI con argumentos

--host --port --transport

-

-

-

Paquete PyPI

mcp-superset

superset-mcp

superset-mcp (npm)

-

Soporte uvx

-

-

-

Licencia

MIT

MIT

-

Apache 2.0

Estrellas en GitHub

nuevo

170

21

5

Diferenciadores clave:

  • Único servidor MCP con gestión de seguridad completa (usuarios, roles, RLS, grupos, auditoría de permisos)

  • Único con validaciones de seguridad integradas (indicadores de confirmación, bloqueo de DDL/DML)

  • Único con gestión de filtros nativos de panel

  • Único con sincronización automática de datasource_access

  • Único con múltiples opciones de transporte (HTTP, SSE, stdio)

  • Único con CLI configurable (--host, --port, --transport, --env-file)

Related MCP server: Superset MCP Server

Características

  • 137 herramientas MCP que cubren la API REST completa de Superset

  • Gestión de paneles: CRUD, copiar, publicar/despublicar, exportar/importar, modo incrustado, filtros nativos

  • Gestión de gráficos: CRUD, copiar, recuperación de datos, exportar/importar, calentamiento de caché

  • Gestión de bases de datos: CRUD, prueba de conexión, introspección de esquemas/tablas, validación SQL

  • Gestión de conjuntos de datos: CRUD, duplicar, actualizar esquema, exportar/importar

  • SQL Lab: ejecución de consultas, formato, estimación de costos, resultados y exportación a CSV

  • Seguridad: usuarios, roles, permisos, seguridad a nivel de fila (RLS), grupos

  • Automatización del control de acceso: conceder/revocar acceso a paneles con sincronización automática de permisos de origen de datos

  • Auditoría: matriz de permisos completa (usuario x paneles x conjuntos de datos x RLS)

  • Etiquetas, informes, anotaciones, consultas guardadas: CRUD completo

  • Exportación/importación de activos: copia de seguridad y restauración completa de la instancia

  • Seguridad integrada: indicadores de confirmación para operaciones destructivas, bloqueo de DDL/DML en SQL Lab

  • Autenticación JWT con actualización automática de token y manejo de CSRF

  • Transportes HTTP, SSE y stdio transmitibles

Inicio rápido

Instalación

# From PyPI
pip install mcp-superset

# With uv (recommended)
uv pip install mcp-superset

# Run without installing (uvx)
uvx mcp-superset

Configuración

Cree un archivo .env en el directorio actual o establezca variables de entorno:

# Required
SUPERSET_BASE_URL=https://superset.example.com
SUPERSET_USERNAME=admin
SUPERSET_PASSWORD=your_password

# Optional
SUPERSET_AUTH_PROVIDER=db          # db (default) or ldap
SUPERSET_MCP_HOST=127.0.0.1       # Server host (default: 127.0.0.1)
SUPERSET_MCP_PORT=8001             # Server port (default: 8001)
SUPERSET_MCP_TRANSPORT=streamable-http  # streamable-http (default), sse, or stdio

Ejecución

# Using CLI (after pip install)
mcp-superset

# Run without installing
uvx mcp-superset

# Using Python module
python -m mcp_superset

# With uv from source
uv run mcp-superset

# With custom settings
mcp-superset --host 0.0.0.0 --port 9000 --transport sse

# With custom .env file
mcp-superset --env-file /path/to/.env

# Using stdio transport (for Claude Desktop, Cursor, etc.)
mcp-superset --transport stdio

Opciones de CLI

Opción

Predeterminado

Variable de entorno

Descripción

--host

127.0.0.1

SUPERSET_MCP_HOST

Dirección de enlace del servidor

--port

8001

SUPERSET_MCP_PORT

Puerto de enlace del servidor

--transport

streamable-http

SUPERSET_MCP_TRANSPORT

Transporte: streamable-http, sse, stdio

--env-file

detección automática

Ruta al archivo .env

--version

Mostrar versión y salir

Conexión a clientes MCP

Claude Code

Agréguelo al archivo .mcp.json de su proyecto:

{
  "mcpServers": {
    "superset": {
      "type": "http",
      "url": "http://localhost:8001/mcp"
    }
  }
}

Luego inicie el servidor: mcp-superset o uvx mcp-superset.

Claude Desktop

Agréguelo a claude_desktop_config.json:

{
  "mcpServers": {
    "superset": {
      "command": "uvx",
      "args": ["mcp-superset", "--transport", "stdio"],
      "env": {
        "SUPERSET_BASE_URL": "https://superset.example.com",
        "SUPERSET_USERNAME": "admin",
        "SUPERSET_PASSWORD": "your_password"
      }
    }
  }
}

Cursor / Windsurf

{
  "mcpServers": {
    "superset": {
      "command": "uvx",
      "args": ["mcp-superset", "--transport", "stdio"],
      "env": {
        "SUPERSET_BASE_URL": "https://superset.example.com",
        "SUPERSET_USERNAME": "admin",
        "SUPERSET_PASSWORD": "your_password"
      }
    }
  }
}

Otros clientes MCP

Cualquier cliente compatible con MCP puede conectarse a través de:

  • Streamable HTTP: http://<host>:<port>/mcp

  • SSE: http://<host>:<port>/sse

  • stdio: canalizar a mcp-superset --transport stdio

Herramientas disponibles (137)

Paneles (15 herramientas)

Herramienta

Descripción

superset_dashboard_list

Listar paneles con filtrado y paginación

superset_dashboard_get

Obtener detalles del panel por ID

superset_dashboard_create

Crear un nuevo panel

superset_dashboard_update

Actualizar propiedades del panel

superset_dashboard_delete

Eliminar un panel (requiere confirmación)

superset_dashboard_copy

Duplicar un panel

superset_dashboard_publish

Publicar un panel en borrador

superset_dashboard_unpublish

Despublicar un panel

superset_dashboard_charts

Listar gráficos en un panel

superset_dashboard_datasets

Listar conjuntos de datos utilizados por un panel

superset_dashboard_export

Exportar panel como ZIP (base64)

superset_dashboard_import

Importar panel desde archivo ZIP

superset_dashboard_embedded_get

Obtener configuración incrustada

superset_dashboard_embedded_set

Habilitar modo incrustado con dominios permitidos

superset_dashboard_embedded_delete

Deshabilitar modo incrustado

Filtros de panel (5 herramientas)

Herramienta

Descripción

superset_dashboard_filter_list

Listar filtros nativos en un panel

superset_dashboard_filter_add

Agregar un filtro nativo (genera automáticamente el formato de ID correcto)

superset_dashboard_filter_update

Actualizar un filtro nativo existente

superset_dashboard_filter_delete

Eliminar un filtro nativo (requiere confirmación)

superset_dashboard_filter_reset

Eliminar todos los filtros (requiere confirmación)

Gráficos (11 herramientas)

Herramienta

Descripción

superset_chart_list

Listar gráficos con filtrado y paginación

superset_chart_get

Obtener detalles del gráfico por ID

superset_chart_create

Crear un nuevo gráfico

superset_chart_update

Actualizar propiedades del gráfico

superset_chart_delete

Eliminar un gráfico (requiere confirmación)

superset_chart_copy

Duplicar un gráfico

superset_chart_data

Ejecutar consulta de gráfico y obtener datos

superset_chart_get_data

Obtener datos de un gráfico guardado

superset_chart_export

Exportar gráfico como ZIP (base64)

superset_chart_import

Importar gráfico desde archivo ZIP

superset_chart_cache_warmup

Calentar caché de gráfico

Bases de datos (18 herramientas)

Herramienta

Descripción

superset_database_list

Listar conexiones de base de datos

superset_database_get

Obtener detalles de la base de datos

superset_database_create

Registrar una nueva conexión de base de datos

superset_database_update

Actualizar configuración de base de datos

superset_database_delete

Eliminar una base de datos (requiere confirmación)

superset_database_test_connection

Probar conectividad de base de datos

superset_database_schemas

Listar esquemas en una base de datos

superset_database_tables

Listar tablas en un esquema

superset_database_catalogs

Listar catálogos (para bases de datos con múltiples catálogos)

superset_database_connection_info

Obtener información de la cadena de conexión

superset_database_function_names

Listar funciones SQL disponibles

superset_database_related_objects

Encontrar gráficos/conjuntos de datos que usan esta base de datos

superset_database_validate_sql

Validar sintaxis SQL

superset_database_validate_parameters

Validar parámetros de conexión

superset_database_select_star

Generar consulta SELECT * para una tabla

superset_database_table_metadata

Obtener metadatos de columnas e índices de tabla

superset_database_export

Exportar configuración de base de datos como ZIP

superset_database_available_engines

Listar motores de base de datos compatibles

Conjuntos de datos (11 herramientas)

Herramienta

Descripción

superset_dataset_list

Listar conjuntos de datos con filtrado

superset_dataset_get

Obtener detalles del conjunto de datos, incluidas columnas y métricas

superset_dataset_create

Crear un conjunto de datos a partir de una tabla o consulta SQL

superset_dataset_update

Actualizar propiedades del conjunto de datos

superset_dataset_delete

Eliminar un conjunto de datos (requiere confirmación)

superset_dataset_duplicate

Duplicar un conjunto de datos

superset_dataset_refresh_schema

Actualizar columnas desde el origen

superset_dataset_related_objects

Encontrar gráficos que usan este conjunto de datos

superset_dataset_export

Exportar conjunto de datos como ZIP

superset_dataset_import

Importar conjunto de datos desde ZIP

superset_dataset_get_or_create

Obtener conjunto de datos existente o crear uno nuevo

SQL Lab y consultas (13 herramientas)

Herramienta

Descripción

superset_sqllab_execute

Ejecutar una consulta SQL (solo SELECT)

superset_sqllab_format_sql

Formatear/embellecer

Install Server
A
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
23dResponse time
2wRelease cycle
12Releases (12mo)
Commit activity
Issues opened vs closed

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    MCP server enabling AI agents to programmatically connect to and control Apache Superset instances, allowing users to manage dashboards, charts, databases, datasets, and run SQL queries through natural language interactions.
    60
    189
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server for Apache Superset that enables AI models to manage dashboards, create charts with auto-detection, and execute SQL queries programmatically. It utilizes stateless HTTP transport to ensure compatibility with integration tools like Open WebUI.
    194
    MIT
  • F
    license
    B
    quality
    D
    maintenance
    An MCP server that provides AI assistants with full access to Apache Superset instances, enabling interaction with dashboards, charts, datasets, databases, and SQL execution capabilities.
    34

View all related MCP servers

Related MCP Connectors

  • MCP server for interacting with the Supabase platform

  • Butterbase MCP server — manage your backend: schemas, auth, functions, storage, RAG, deploys.

  • Security-first WordPress MCP server. 129 tools for Claude, ChatGPT, Gemini. Free on wp.org.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bintocher/mcp-superset'

If you have feedback or need assistance with the MCP directory API, please join our Discord server