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

这是一个为 Apache Superset 提供的综合 模型上下文协议 (MCP) 服务器。它通过 137 个工具让 AI 助手(Claude、GPT 等)能够完全控制您的 Superset 实例,包括仪表板、图表、数据集、SQL Lab、用户、角色、RLS 等。

与其他 Superset MCP 服务器的对比

特性

mcp-superset

superset-mcp

superset-mcp (Winding2020)

superset-mcp-server

工具总数

137

60

31

4

语言

Python

Python

TypeScript

TypeScript

仪表板 CRUD

15 个工具

5

8

-

仪表板原生筛选器

5 个工具

-

-

-

图表 CRUD

11 个工具

5

7

-

数据库工具

18 个工具

14

1

1

数据集工具

11 个工具

3

7

-

SQL Lab

5 个工具

7

1

1

安全性(用户/角色)

26 个工具

2

-

-

行级安全性 (RLS)

5 个工具

-

-

-

9 个工具

-

-

-

权限审计

-

-

-

仪表板访问权限授予/撤销

-

-

-

自动 datasource_access 同步

-

-

-

报告与注释

10 个工具

-

-

-

标签

7 个工具

7

-

-

资产导出/导入

-

-

-

安全:确认标志

14 种类型

-

-

-

安全:DDL/DML 拦截

-

-

-

安全:系统角色保护

-

-

-

传输方式

HTTP, SSE, stdio

stdio

stdio

stdio

认证方式

JWT + 自动刷新 + CSRF

用户名/密码 + 令牌文件

用户名/密码或令牌

LDAP

Superset 版本

6.0.1

4.1.1

未指定

未指定

带参数的 CLI

--host --port --transport

-

-

-

PyPI 包

mcp-superset

superset-mcp

superset-mcp (npm)

-

uvx 支持

-

-

-

许可证

MIT

MIT

-

Apache 2.0

GitHub 星标

170

21

5

主要区别:

  • 唯一具备完整安全管理(用户、角色、RLS、组、权限审计)的 MCP 服务器

  • 唯一具备内置安全验证(确认标志、DDL/DML 拦截)的服务器

  • 唯一具备仪表板原生筛选器管理的服务器

  • 唯一具备自动 datasource_access 同步的服务器

  • 唯一具备多种传输选项(HTTP、SSE、stdio)的服务器

  • 唯一具备可配置 CLI--host, --port, --transport, --env-file)的服务器

Related MCP server: Superset MCP Server

功能

  • 137 个 MCP 工具,涵盖完整的 Superset REST API

  • 仪表板管理 — CRUD、复制、发布/取消发布、导出/导入、嵌入模式、原生筛选器

  • 图表管理 — CRUD、复制、数据检索、导出/导入、缓存预热

  • 数据库管理 — CRUD、连接测试、模式/表内省、SQL 验证

  • 数据集管理 — CRUD、复制、模式刷新、导出/导入

  • SQL Lab — 查询执行、格式化、成本估算、结果及 CSV 导出

  • 安全性 — 用户、角色、权限、行级安全性 (RLS)、组

  • 访问控制自动化 — 授予/撤销仪表板访问权限,并自动同步数据源权限

  • 审计 — 全面的权限矩阵(用户 x 仪表板 x 数据集 x RLS)

  • 标签、报告、注释、已保存查询 — 全面 CRUD

  • 资产导出/导入 — 完整的实例备份与恢复

  • 内置安全 — 针对破坏性操作的确认标志,SQL Lab 中的 DDL/DML 拦截

  • JWT 认证,支持自动令牌刷新和 CSRF 处理

  • 可流式传输的 HTTP、SSE 和 stdio 传输方式

快速入门

安装

# From PyPI
pip install mcp-superset

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

# Run without installing (uvx)
uvx mcp-superset

配置

在当前目录中创建一个 .env 文件,或设置环境变量:

# 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

运行

# 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

CLI 选项

选项

默认值

环境变量

描述

--host

127.0.0.1

SUPERSET_MCP_HOST

服务器绑定地址

--port

8001

SUPERSET_MCP_PORT

服务器绑定端口

--transport

streamable-http

SUPERSET_MCP_TRANSPORT

传输方式: streamable-http, sse, stdio

--env-file

自动检测

.env 文件路径

--version

显示版本并退出

连接到 MCP 客户端

Claude Code

添加到项目的 .mcp.json 中:

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

然后启动服务器:mcp-supersetuvx mcp-superset

Claude Desktop

添加到 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"
      }
    }
  }
}

其他 MCP 客户端

任何兼容 MCP 的客户端都可以通过以下方式连接:

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

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

  • stdio: 管道传输至 mcp-superset --transport stdio

可用工具 (137)

仪表板 (15 个工具)

工具

描述

superset_dashboard_list

列出仪表板(支持筛选和分页)

superset_dashboard_get

按 ID 获取仪表板详情

superset_dashboard_create

创建新仪表板

superset_dashboard_update

更新仪表板属性

superset_dashboard_delete

删除仪表板(需要确认)

superset_dashboard_copy

复制仪表板

superset_dashboard_publish

发布草稿仪表板

superset_dashboard_unpublish

取消发布仪表板

superset_dashboard_charts

列出仪表板中的图表

superset_dashboard_datasets

列出仪表板使用的数据集

superset_dashboard_export

将仪表板导出为 ZIP (base64)

superset_dashboard_import

从 ZIP 文件导入仪表板

superset_dashboard_embedded_get

获取嵌入配置

superset_dashboard_embedded_set

启用嵌入模式并设置允许的域名

superset_dashboard_embedded_delete

禁用嵌入模式

仪表板筛选器 (5 个工具)

工具

描述

superset_dashboard_filter_list

列出仪表板上的原生筛选器

superset_dashboard_filter_add

添加原生筛选器(自动生成正确的 ID 格式)

superset_dashboard_filter_update

更新现有的原生筛选器

superset_dashboard_filter_delete

移除原生筛选器(需要确认)

superset_dashboard_filter_reset

移除所有筛选器(需要确认)

图表 (11 个工具)

工具

描述

superset_chart_list

列出图表(支持筛选和分页)

superset_chart_get

按 ID 获取图表详情

superset_chart_create

创建新图表

superset_chart_update

更新图表属性

superset_chart_delete

删除图表(需要确认)

superset_chart_copy

复制图表

superset_chart_data

执行图表查询并获取数据

superset_chart_get_data

从已保存的图表获取数据

superset_chart_export

将图表导出为 ZIP (base64)

superset_chart_import

从 ZIP 文件导入图表

superset_chart_cache_warmup

预热图表缓存

数据库 (18 个工具)

工具

描述

superset_database_list

列出数据库连接

superset_database_get

获取数据库详情

superset_database_create

注册新的数据库连接

superset_database_update

更新数据库设置

superset_database_delete

移除数据库(需要确认)

superset_database_test_connection

测试数据库连接性

superset_database_schemas

列出数据库中的模式

superset_database_tables

列出模式中的表

superset_database_catalogs

列出目录(针对多目录数据库)

superset_database_connection_info

获取连接字符串信息

superset_database_function_names

列出可用的 SQL 函数

superset_database_related_objects

查找使用此数据库的图表/数据集

superset_database_validate_sql

验证 SQL 语法

superset_database_validate_parameters

验证连接参数

superset_database_select_star

为表生成 SELECT * 查询

superset_database_table_metadata

获取表列和索引元数据

superset_database_export

将数据库配置导出为 ZIP

superset_database_available_engines

列出支持的数据库引擎

数据集 (11 个工具)

工具

描述

superset_dataset_list

列出数据集(支持筛选)

superset_dataset_get

获取数据集详情(包括列和指标)

superset_dataset_create

从表或 SQL 查询创建数据集

superset_dataset_update

更新数据集属性

superset_dataset_delete

删除数据集(需要确认)

superset_dataset_duplicate

复制数据集

superset_dataset_refresh_schema

从源刷新列

superset_dataset_related_objects

查找使用此数据集的图表

superset_dataset_export

将数据集导出为 ZIP

superset_dataset_import

从 ZIP 导入数据集

superset_dataset_get_or_create

获取现有数据集或创建新数据集

SQL Lab 与查询 (13 个工具)

工具

描述

superset_sqllab_execute

执行 SQL 查询(仅限 SELECT)

superset_sqllab_format_sql

格式化/美化 SQL

superset_sqllab_results

获取已完成查询的结果

superset_sqllab_estimate_cost

估算查询执行成本

superset_sqllab_export_csv

将查询结果导出为 CSV

superset_query_list

列出已执行的查询

superset_query_get

获取查询详情和结果

superset_query_stop

停止正在运行的查询

superset_saved_query_list

列出已保存的查询

superset_saved_query_create

保存新查询

superset_saved_query_get

获取已保存查询的详情

superset_saved_query_update

更新已保存的查询

superset_saved_query_delete

删除已保存的查询(需要确认)

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