Superset MCP Integration

基本能力

产品定位

Superset MCP Integration 是一个中间件，用于连接 AI 代理和 Apache Superset，实现程序化的 Superset 实例控制和管理。

核心功能

1. 仪表板管理：创建、查看、更新和删除仪表板
2. 图表管理：创建、查看、更新和删除图表
3. 数据库和数据集操作：管理数据库连接、数据集和执行 SQL 查询
4. SQL Lab 功能：执行、格式化和估算 SQL 查询成本
5. 用户和系统信息：获取用户信息、角色和系统状态
6. 标签管理：创建、删除和管理对象标签

适用场景

1. 自动化 Superset 实例管理
2. 通过自然语言与 Superset 交互
3. 批量操作 Superset 资源
4. 集成 Superset 到 AI 代理工作流

工具列表

1. 认证工具：检查令牌有效性、刷新令牌、用户认证
2. 仪表板工具：列表、获取、创建、更新和删除仪表板
3. 图表工具：列表、获取、创建、更新和删除图表
4. 数据库工具：管理数据库连接、表、模式和函数
5. SQL Lab 工具：执行查询、格式化 SQL、获取结果
6. 用户信息工具：获取当前用户信息和角色
7. 标签工具：管理标签和对象关联

常见问题解答

1. 认证问题：检查 .env 文件中的凭证
2. 连接问题：确保 Superset 运行并可访问
3. 版本兼容性：使用 Superset 4.1.1 版本
4. 端口冲突：确保 MCP 服务器端口未被占用

使用教程

使用依赖

1. 安装 Docker 和 Git

安装教程

1. 设置本地 Superset

git clone --branch 4.1.1 --depth 1 https://github.com/apache/superset && \
cd superset && \
docker compose -f docker-compose-image-tag.yml up

1. 克隆仓库
2. 配置环境变量 创建 .env 文件：

SUPERSET_BASE_URL=http://localhost:8088
SUPERSET_USERNAME=your_username
SUPERSET_PASSWORD=your_password

1. 安装依赖

uv pip install .

1. 安装 MCP 配置

mcp install main.py

调试方式

1. 检查 Superset 是否运行在 http://localhost:8088
2. 验证 .env 文件中的凭证
3. 检查 .superset_token 文件是否存在
4. 测试基本命令如 superset_dashboard_list

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。