1. 概述

Apache Superset MCP 集成（superset-mcp）是一個基于 Model Control Protocol（MCP）的服務(wù)器工具，旨在實現(xiàn) AI 代理與 Apache Superset 的程序化交互。該項目通過提供標(biāo)準(zhǔn)化的工具接口，使 AI 助手（如 Claude）能夠連接并控制 Superset 實例，實現(xiàn)數(shù)據(jù)可視化、報表生成、SQL 查詢等操作的自動化。

項目倉庫：https://github.com/aptro/superset-mcp

2. 核心功能與架構(gòu)

2.1 核心定位

superset-mcp 作為 Superset 與 AI 代理之間的中間層，主要解決以下問題：

• 提供標(biāo)準(zhǔn)化接口，使 AI 代理能夠理解和操作 Superset
• 處理認(rèn)證與權(quán)限管理
• 封裝 Superset API 為更適合 AI 調(diào)用的工具集
• 實現(xiàn)令牌自動刷新與會話管理

2.2 技術(shù)架構(gòu)

• 基礎(chǔ)框架：基于 FastAPI 構(gòu)建的 MCP 服務(wù)器
• 通信層：使用 httpx 處理與 Superset 的 HTTP 通信
• 認(rèn)證機制：基于令牌的認(rèn)證系統(tǒng)，支持自動刷新
• 工具抽象：將 Superset 功能封裝為可調(diào)用的 MCP 工具
• 配置管理：通過環(huán)境變量和 .env 文件管理連接參數(shù)

3. 安裝與配置

3.1 安裝方式

方式 1：通過 Smithery 安裝（推薦用于 Claude 桌面端）

npx -y @smithery/cli install @aptro/superset-mcp --client claude

方式 2：手動安裝

# 克隆倉庫
git clone https://github.com/aptro/superset-mcp.git
cd superset-mcp
# 安裝依賴
uv pip install .

3.2 環(huán)境配置

創(chuàng)建 .env 文件配置 Superset 連接信息：

SUPERSET_BASE_URL=http://localhost:8088  # Superset 實例地址
SUPERSET_USERNAME=admin                  # Superset 用戶名
SUPERSET_PASSWORD=admin                  # Superset 密碼

3.3 啟動 Superset 實例

推薦使用 4.1.1 版本（經(jīng)測試兼容）：

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

4. 核心工具集

superset-mcp 提供了豐富的 MCP 工具，覆蓋 Superset 主要功能領(lǐng)域，以下是分類說明：

4.1 認(rèn)證相關(guān)工具

• superset_auth_check_token_validity - 驗證當(dāng)前訪問令牌有效性
• superset_auth_refresh_token - 刷新訪問令牌
• superset_auth_authenticate_user - 用戶認(rèn)證

4.2 儀表盤操作

• superset_dashboard_list - 列出所有儀表盤
• superset_dashboard_get_by_id - 獲取特定儀表盤詳情
• superset_dashboard_create - 創(chuàng)建新儀表盤
• superset_dashboard_update - 更新現(xiàn)有儀表盤
• superset_dashboard_delete - 刪除儀表盤

4.3 圖表管理

• superset_chart_list - 列出所有圖表
• superset_chart_get_by_id - 獲取特定圖表詳情
• superset_chart_create - 創(chuàng)建新圖表
• superset_chart_update - 更新現(xiàn)有圖表
• superset_chart_delete - 刪除圖表

4.4 數(shù)據(jù)庫與數(shù)據(jù)集

• superset_database_list - 列出所有數(shù)據(jù)庫連接
• superset_database_get_tables - 獲取數(shù)據(jù)庫中的表
• superset_dataset_list - 列出所有數(shù)據(jù)集
• superset_dataset_create - 創(chuàng)建新數(shù)據(jù)集

4.5 SQL 實驗室功能

• superset_sqllab_execute_query - 執(zhí)行 SQL 查詢
• superset_sqllab_format_sql - 格式化 SQL 語句
• superset_sqllab_get_results - 獲取查詢結(jié)果
• superset_sqllab_estimate_query_cost - 估算查詢成本
• superset_sqllab_export_query_results - 導(dǎo)出查詢結(jié)果為 CSV

4.6 其他工具

• 探索工具（superset_explore_*）- 圖表探索與 permalink 管理
• 標(biāo)簽管理（superset_tag_*）- 標(biāo)簽的創(chuàng)建、刪除與關(guān)聯(lián)
• 用戶信息（superset_user_*）- 獲取當(dāng)前用戶信息與角色
• 系統(tǒng)信息（superset_menu_get, superset_config_get_base_url）

5. 使用示例

5.1 基礎(chǔ)使用流程

from mcp.server.fastmcp import Context
from superset_mcp.main import mcp, superset_dashboard_list, superset_sqllab_execute_query
# 初始化上下文（實際使用中由 MCP 服務(wù)器管理）
class MockContext:
    def __init__(self, lifespan_context):
        self.request_context = type('', (), {'lifespan_context': lifespan_context})()
# 列出所有儀表盤
async def list_dashboards(ctx: Context):
    result = await superset_dashboard_list(ctx)
    print("所有儀表盤：", result)
# 執(zhí)行 SQL 查詢
async def run_sql_query(ctx: Context, database_id: int, sql: str):
    result = await superset_sqllab_execute_query(
        ctx,
        database_id=database_id,
        sql=sql
    )
    print("查詢結(jié)果：", result)
# 運行示例（需在異步環(huán)境中執(zhí)行）
if __name__ == "__main__":
    import asyncio
    asyncio.run(list_dashboards(MockContext(mcp.lifespan_context)))
    asyncio.run(run_sql_query(MockContext(mcp.lifespan_context), 1, "SELECT * FROM users LIMIT 10"))

5.2 與 Claude 交互示例

通過自然語言指令使用 Superset 功能：

• “列出我所有的儀表盤”
• “運行這個 SQL 查詢：SELECT COUNT(*) FROM orders”
• “格式化這段 SQL：SELECT id,name,age FROM users WHERE age>21”
• “創(chuàng)建一個新的柱狀圖，展示每月銷售額”

6. 安全性考量

• 憑據(jù)存儲：Superset 用戶名和密碼僅存儲在本地 .env 文件中
• 令牌管理：訪問令牌存儲在項目目錄的 .superset_token 文件中
• 通信安全：所有認(rèn)證操作直接在 MCP 服務(wù)器與 Superset 實例之間進行
• 第三方隔離：不會向 Claude 或其他第三方傳輸任何憑據(jù)信息
• 生產(chǎn)建議：生產(chǎn)環(huán)境中應(yīng)使用更安全的認(rèn)證方法，而非基本用戶名/密碼認(rèn)證

7. 故障排除

• 認(rèn)證問題：檢查 .env 文件中的憑據(jù)是否正確
• 連接問題：確認(rèn) Superset 實例正在運行且 URL 正確
• 版本兼容：確保使用兼容的 Superset 版本（推薦 4.1.1）
• 端口沖突：檢查 MCP 服務(wù)器端口是否被其他應(yīng)用占用

8. 許可證與貢獻

• 許可證：項目采用 MIT 許可證，允許自由使用、復(fù)制、修改和分發(fā)
• 貢獻方式：歡迎通過提交 Pull Request 參與項目開發(fā)

9. 總結(jié)

superset-mcp 為 Apache Superset 提供了強大的 AI 集成能力，通過標(biāo)準(zhǔn)化的 MCP 工具集，使 AI 代理能夠以自然語言交互的方式操作 Superset。該項目降低了數(shù)據(jù)分析與可視化的技術(shù)門檻，特別適合需要快速生成報表、執(zhí)行查詢和管理數(shù)據(jù)資產(chǎn)的場景。

未來發(fā)展方向可能包括擴展更多 Superset 功能、優(yōu)化 AI 交互體驗，以及增強安全性和企業(yè)級特性。

到此這篇關(guān)于【服務(wù)器】Apache Superset MCP接入與使用的文章就介紹到這了,更多相關(guān)Apache Superset MCP使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論