Apache Superset과 상호작용하기 위한 MCP 서버로, AI 에이전트가 SuperSet 인스턴스에 프로그래밍적으로 연결하고 제어할 수 있게 합니다.

설정 지침

Smithery를 통해 설치 중

Smithery를 통해 Claude Desktop용 Superset Integration을 자동으로 설치하려면:

수동 설치

1. 로컬에서 슈퍼세트를 설정하세요

이 스크립트를 실행하여 Superset을 로컬에서 시작하세요:

Superset이 실행되면 기본 자격 증명으로 http://localhost:8088에서 접근할 수 있을 것입니다:

• 사용자 이름: admin
• 비밀번호: admin

2. 이 저장소를 복제하세요

이 저장소를 로컬 컴퓨터에 복제하세요.

3. **환경 변수 구성

루트 디렉터리에 Superset 자격 증명으로 .env 파일을 생성하세요:

4. **의존성 설치

5. Claude용 MCP 설정 설치

Claude 데스크톱 앱과 함께 사용하려면:

클로드와의 사용

설정 후에는 자연어 요청을 통해 Claude를 통해 Superset 인스턴스와 상호작용할 수 있습니다. 다음은 몇 가지 예시입니다:

대시보드 관리

• 대시보드 보기: “내 모든 슈퍼셋 대시보드를 보여주세요”
• 대시보드 세부 정보 가져오기: “ID 5로 대시보드 세부 정보를 보여주세요”

Superset MCP Integration

MCP server for interacting with Apache Superset, enabling AI agents to connect to and control a Superset instance programmatically.

Setup Instructions

Installing via Smithery

To install Superset Integration for Claude Desktop automatically via Smithery:

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

Manual Installation

1. Set Up Superset Locally

   Run this script to start Superset locally:

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

   Once Superset is running, you should be able to access it at http://localhost:8088 with default credentials:

   • Username: admin
   • Password: admin

2. Clone This Repository

   Clone this repository to your local machine.

3. Configure Environment Variables

   Create a .env file in the root directory with your Superset credentials:

   SUPERSET_BASE_URL=http://localhost:8088  # Change to your Superset URL
   SUPERSET_USERNAME=your_username
   SUPERSET_PASSWORD=your_password
   

4. Install Dependencies

   uv pip install .
   

5. Install MCP Config for Claude

   To use with Claude Desktop app:

   mcp install main.py
   

Usage with Claude

After setup, you can interact with your Superset instance via Claude using natural language requests. Here are some examples:

Dashboard Management

• View dashboards: “Show me all my Superset dashboards”
• Get dashboard details: “Show me the details of dashboard with ID 5”
• Create dashboard: “Create a new dashboard titled ‘Sales Overview’”
• Update dashboard: “Update dashboard 3 to have the title ‘Updated Sales Report’”
• Delete dashboard: “Delete dashboard with ID 7”

Chart Management

• List all charts: “What charts do I have in my Superset instance?”
• View chart details: “Show me the details of chart with ID 10”
• Create chart: “Create a new bar chart using dataset 3”
• Update chart: “Update chart 5 to use a line visualization instead of bar”
• Delete chart: “Delete chart with ID 12”

Database and Dataset Operations

• List databases: “Show me all databases connected to Superset”
• List datasets: “What datasets are available in my Superset instance?”
• Get database tables: “What tables are available in database with ID 1?”
• Execute SQL: “Run this SQL query on database 1: SELECT * FROM users LIMIT 10”
• Create dataset: “Create a new dataset from table ‘customers’ in database 2”
• Update database: “Update the connection settings for database 3”
• Delete database: “Delete database connection with ID 4”