mcp-superset
mcp-superset
这是一个为 Apache Superset 提供的综合 模型上下文协议 (MCP) 服务器。它通过 137 个工具让 AI 助手(Claude、GPT 等)能够完全控制您的 Superset 实例,包括仪表板、图表、数据集、SQL Lab、用户、角色、RLS 等。
与其他 Superset MCP 服务器的对比
特性 | mcp-superset | |||
工具总数 | 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 |
| - | - | - |
PyPI 包 |
|
|
| - |
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 stdioCLI 选项
选项 | 默认值 | 环境变量 | 描述 |
|
|
| 服务器绑定地址 |
|
|
| 服务器绑定端口 |
|
|
| 传输方式: |
| 自动检测 | — |
|
| — | — | 显示版本并退出 |
连接到 MCP 客户端
Claude Code
添加到项目的 .mcp.json 中:
{
"mcpServers": {
"superset": {
"type": "http",
"url": "http://localhost:8001/mcp"
}
}
}然后启动服务器:mcp-superset 或 uvx 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>/mcpSSE:
http://<host>:<port>/ssestdio: 管道传输至
mcp-superset --transport stdio
可用工具 (137)
仪表板 (15 个工具)
工具 | 描述 |
| 列出仪表板(支持筛选和分页) |
| 按 ID 获取仪表板详情 |
| 创建新仪表板 |
| 更新仪表板属性 |
| 删除仪表板(需要确认) |
| 复制仪表板 |
| 发布草稿仪表板 |
| 取消发布仪表板 |
| 列出仪表板中的图表 |
| 列出仪表板使用的数据集 |
| 将仪表板导出为 ZIP (base64) |
| 从 ZIP 文件导入仪表板 |
| 获取嵌入配置 |
| 启用嵌入模式并设置允许的域名 |
| 禁用嵌入模式 |
仪表板筛选器 (5 个工具)
工具 | 描述 |
| 列出仪表板上的原生筛选器 |
| 添加原生筛选器(自动生成正确的 ID 格式) |
| 更新现有的原生筛选器 |
| 移除原生筛选器(需要确认) |
| 移除所有筛选器(需要确认) |
图表 (11 个工具)
工具 | 描述 |
| 列出图表(支持筛选和分页) |
| 按 ID 获取图表详情 |
| 创建新图表 |
| 更新图表属性 |
| 删除图表(需要确认) |
| 复制图表 |
| 执行图表查询并获取数据 |
| 从已保存的图表获取数据 |
| 将图表导出为 ZIP (base64) |
| 从 ZIP 文件导入图表 |
| 预热图表缓存 |
数据库 (18 个工具)
工具 | 描述 |
| 列出数据库连接 |
| 获取数据库详情 |
| 注册新的数据库连接 |
| 更新数据库设置 |
| 移除数据库(需要确认) |
| 测试数据库连接性 |
| 列出数据库中的模式 |
| 列出模式中的表 |
| 列出目录(针对多目录数据库) |
| 获取连接字符串信息 |
| 列出可用的 SQL 函数 |
| 查找使用此数据库的图表/数据集 |
| 验证 SQL 语法 |
| 验证连接参数 |
| 为表生成 SELECT * 查询 |
| 获取表列和索引元数据 |
| 将数据库配置导出为 ZIP |
| 列出支持的数据库引擎 |
数据集 (11 个工具)
工具 | 描述 |
| 列出数据集(支持筛选) |
| 获取数据集详情(包括列和指标) |
| 从表或 SQL 查询创建数据集 |
| 更新数据集属性 |
| 删除数据集(需要确认) |
| 复制数据集 |
| 从源刷新列 |
| 查找使用此数据集的图表 |
| 将数据集导出为 ZIP |
| 从 ZIP 导入数据集 |
| 获取现有数据集或创建新数据集 |
SQL Lab 与查询 (13 个工具)
工具 | 描述 |
| 执行 SQL 查询(仅限 SELECT) |
| 格式化/美化 SQL |
| 获取已完成查询的结果 |
| 估算查询执行成本 |
| 将查询结果导出为 CSV |
| 列出已执行的查询 |
| 获取查询详情和结果 |
| 停止正在运行的查询 |
| 列出已保存的查询 |
| 保存新查询 |
| 获取已保存查询的详情 |
| 更新已保存的查询 |
| 删除已保存的查询(需要确认) |
Maintenance
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP 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.60189MIT
- AlicenseNot gradedqualityCmaintenanceAn 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.194MIT
- FlicenseBqualityDmaintenanceAn 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
- AlicenseBqualityCmaintenanceMCP server for Preset (managed Apache Superset). Manage dashboards, charts, and datasets from Claude Code and other LLM agents.591MIT
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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