MCP Superset

mcp超集

](https://pypi.org/project/mcp-superset/) ](https://pypi.org/project/mcp-superset/)    

      ](https://github.com/bintocher/mcp-superset)

全面的 模型上下文协议（MCP） 服务器 Apache超级集。通过137个工具，让AI助手（Claude、GPT等）完全控制您的Superset实例——仪表板、图表、数据集、SQL Lab、用户、角色、RLS等。

与其他超级MCP服务器的比较

|---------|:-:|:-:|:-:|:-:| | 工具总数 | 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实验室| 5个工具|7|1|1| | 安全（用户/角色） | 26工具 | 2 | - | - | | 行级安全性 | 5工具 | - | - | - | | 群组 | 9工具 | - | - | - | | 权限审核 | 是 | - | - | - | | 仪表板访问权限授予/撤销 | 是 | - | - | - | | 自动数据源_访问同步 | 是 | - | - | - | |报告和注释|10个工具|-|-|-| |标签|7工具|7|-|-| |资产导出/导入|是|-|-|-| | 安全：确认标志 | 14种类型 | - | - | - | | 安全：DDL/DML阻塞 | 是 | - | - | - | | 安全：系统角色保护 | 是 | - | - | - | |传输|HTTP、SSE、stdio|stdio|std io|stdio| |身份验证方法|JWT+自动刷新+CSRF|用户名/密码+令牌文件|用户名/口令或令牌|LDAP| |超级集版本|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|

主要差异化因素：

• 仅MCP服务器具有 全面安全管理 （用户、角色、RLS、组、权限审核）
• 只有一个 内置安全验证 （确认标志，DDL/DML阻塞）
• 只有一个 仪表板本机筛选器管理
• 只有一个 自动数据源访问同步
• 只有一个 多种运输方式 （HTTP、SSE、stdio）
• 只有一个 可配置CLI (--host, --port, --transport, --env-file)

特性

• 137个MCP工具 涵盖完整的Superset REST API
• 仪表板管理 --CRUD、复制、发布/取消发布、导出/导入、嵌入式模式、本机过滤器
• 图表管理 --CRUD、复制、数据检索、导出/导入、缓存预热
• 数据库管理 --CRUD、连接测试、模式/表自检、SQL验证
• 数据集管理 --CRUD、复制、模式刷新、导出/导入
• SQL实验室 --查询执行、格式化、成本估算、结果和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选项

连接到MCP客户端

克劳德代码

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

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

然后启动服务器： mcp-superset 或 uvx mcp-superset.

克劳德桌面

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

光标/风帆

{
  "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的客户端都可以通过以下方式连接：

• 可流式传输的HTTP: `http://:

/mcp`

• 上海证券交易所: `http://:

/sse`

• 标准：管道至 mcp-superset --transport stdio

可用工具（137）

仪表板（15个工具）

仪表板过滤器（5个工具）

图表（11个工具）

数据库（18个工具）

数据集（11个工具）

SQL实验室和查询（13个工具）

安全和访问控制（26个工具）

组（9个工具）

标签（7工具）

系统和报告（21个工具）

审计（1个工具）

安全特性

该服务器包括广泛的内置保护，以防止意外数据丢失或配置错误。

确认标志

破坏性操作需要明确的确认参数：

自动保护

• DDL/DML阻塞 --SQL实验室拒绝 DROP, DELETE, UPDATE, INSERT, TRUNCATE, ALTER, CREATE, GRANT, REVOKE （检查前删除SQL注释）
• 系统角色保护 --无法删除管理员、Alpha、Gamma、公共角色
• 服务帐户保护 --无法删除MCP服务用户
• RLS安全 — rls_update 两者都需要 roles 和 tables 防止无声数据擦除
• 本机筛选器ID --自动生成于 NATIVE_FILTER- 格式
• 图表验证 --不接受图表 granularity_sqla （仪表板时间过滤器需要）
• 自动同步 --当仪表板角色更改时，datasource_access权限会自动同步

建筑

superset-mcp/
├── pyproject.toml              # Package configuration
├── .env.example                # Environment variable template
├── LICENSE                     # MIT License
├── README.md                   # This file
├── README_RU.md                # Russian documentation
├── CHANGELOG.md                # Version history
└── src/mcp_superset/
    ├── __init__.py             # Package init with __version__
    ├── __main__.py             # CLI entry point with argparse
    ├── server.py               # FastMCP server setup and configuration
    ├── auth.py                 # JWT authentication (login, refresh, CSRF)
    ├── client.py               # HTTP client (auto-auth, retry, RISON pagination)
    ├── models.py               # Pydantic models
    └── tools/
        ├── __init__.py         # register_all_tools()
        ├── helpers.py          # Auto-sync datasource_access logic
        ├── dashboards.py       # Dashboard + filter tools (20)
        ├── charts.py           # Chart tools (11)
        ├── databases.py        # Database tools (18)
        ├── datasets.py         # Dataset tools (11)
        ├── queries.py          # SQL Lab + saved query tools (13)
        ├── security.py         # User, role, permission, RLS, bulk operations (26)
        ├── groups.py           # Group management tools (9)
        ├── audit.py            # Permissions audit tool (1)
        ├── tags.py             # Tag tools (7)
        └── system.py           # Reports, annotations, logs, assets (21)

超级集兼容性

• 经过测试：Apache超级集6.0.1
• 认证：JWT（推荐）-API密钥(sst_*)未在Superset中实现
• 必需的Superset用户：管理员角色（用于完全访问API）

推荐的超级设置配置

添加到您的 superset_config.py:

from datetime import timedelta

# Increase JWT token lifetime (default is 15 min)
JWT_ACCESS_TOKEN_EXPIRES = timedelta(hours=1)
JWT_REFRESH_TOKEN_EXPIRES = timedelta(days=30)

# Max API page size
FAB_API_MAX_PAGE_SIZE = 100

发展

设置

git clone https://github.com/bintocher/mcp-superset.git
cd superset-mcp

# Create virtual environment and install in editable mode
uv venv
uv pip install -e ".[dev]"

# Copy and configure .env
cp .env.example .env
# Edit .env with your Superset credentials

本地运行

# Run from source
uv run python -m mcp_superset

# Or with CLI
uv run mcp-superset --port 8001

运行测试

uv run python test_all_tools.py

已知超级集合API测验

这些由MCP服务器自动处理，但在调试时了解这些信息很有用：

许可证