基本能力
产品定位
Superset MCP Integration 是一个中间件,用于连接 AI 代理和 Apache Superset,实现程序化的 Superset 实例控制和管理。
核心功能
- 仪表板管理:创建、查看、更新和删除仪表板
- 图表管理:创建、查看、更新和删除图表
- 数据库和数据集操作:管理数据库连接、数据集和执行 SQL 查询
- SQL Lab 功能:执行、格式化和估算 SQL 查询成本
- 用户和系统信息:获取用户信息、角色和系统状态
- 标签管理:创建、删除和管理对象标签
适用场景
- 自动化 Superset 实例管理
- 通过自然语言与 Superset 交互
- 批量操作 Superset 资源
- 集成 Superset 到 AI 代理工作流
工具列表
- 认证工具:检查令牌有效性、刷新令牌、用户认证
- 仪表板工具:列表、获取、创建、更新和删除仪表板
- 图表工具:列表、获取、创建、更新和删除图表
- 数据库工具:管理数据库连接、表、模式和函数
- SQL Lab 工具:执行查询、格式化 SQL、获取结果
- 用户信息工具:获取当前用户信息和角色
- 标签工具:管理标签和对象关联
常见问题解答
- 认证问题:检查
.env
文件中的凭证 - 连接问题:确保 Superset 运行并可访问
- 版本兼容性:使用 Superset 4.1.1 版本
- 端口冲突:确保 MCP 服务器端口未被占用
使用教程
使用依赖
- 安装 Docker 和 Git
安装教程
- 设置本地 Superset
bash
git clone --branch 4.1.1 --depth 1 https://github.com/apache/superset && \
cd superset && \
docker compose -f docker-compose-image-tag.yml up - 克隆仓库
- 配置环境变量
创建.env
文件:
SUPERSET_BASE_URL=http://localhost:8088
SUPERSET_USERNAME=your_username
SUPERSET_PASSWORD=your_password - 安装依赖
bash
uv pip install . - 安装 MCP 配置
bash
mcp install main.py
调试方式
- 检查 Superset 是否运行在 http://localhost:8088
- 验证
.env
文件中的凭证 - 检查
.superset_token
文件是否存在 - 测试基本命令如
superset_dashboard_list