superset-mcp

MCP-сервер (Model Context Protocol) для Apache Superset. Предоставляет ИИ-ассистентам полный доступ к вашему экземпляру Superset — дашбордам, графикам, наборам данных, базам данных и выполнению SQL-запросов.

Предварительные требования

uv — менеджер пакетов Python
Доступ к работающему экземпляру Apache Superset

Настройка (занимает ~1 минуту)

1. Клонируйте репозиторий

git clone <repo-url>
cd superset-mcp

2. Настройте учетные данные

cp .env.example .env

Отредактируйте файл .env:

SUPERSET_URL=http://your-superset-host:8088
SUPERSET_USERNAME=your-username
SUPERSET_PASSWORD=your-password

3. Проверьте работоспособность

uv run superset-mcp

Вы должны увидеть, что MCP-сервер запустился без ошибок. Нажмите Ctrl+C для остановки.

Подключение к вашему ИИ-клиенту

Замените /ABSOLUTE/PATH/TO/superset-mcp на фактический путь, по которому вы клонировали репозиторий.

Claude Code

Добавьте в ~/.claude/settings.json (или в .claude/settings.json на уровне проекта):

{
  "mcpServers": {
    "superset": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/superset-mcp", "run", "superset-mcp"],
      "env": {
        "SUPERSET_URL": "http://your-superset-host:8088",
        "SUPERSET_USERNAME": "your-username",
        "SUPERSET_PASSWORD": "your-password"
      }
    }
  }
}

Или выполните в терминале:

claude mcp add superset -- uv --directory /ABSOLUTE/PATH/TO/superset-mcp run superset-mcp

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "superset": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/superset-mcp", "run", "superset-mcp"],
      "env": {
        "SUPERSET_URL": "http://your-superset-host:8088",
        "SUPERSET_USERNAME": "your-username",
        "SUPERSET_PASSWORD": "your-password"
      }
    }
  }
}

Cursor

Добавьте в .cursor/mcp.json в вашем проекте или глобально в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "superset": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/superset-mcp", "run", "superset-mcp"],
      "env": {
        "SUPERSET_URL": "http://your-superset-host:8088",
        "SUPERSET_USERNAME": "your-username",
        "SUPERSET_PASSWORD": "your-password"
      }
    }
  }
}

Доступные инструменты

Дашборды

Инструмент	Описание
`list_dashboards`	Список всех дашбордов (с опциональным поиском)
`get_dashboard`	Получить дашборд по ID или слагу
`get_dashboard_charts`	Получить все графики на дашборде
`get_dashboard_datasets`	Получить все наборы данных, используемые на дашборде
`create_dashboard`	Создать новый дашборд
`update_dashboard`	Обновить заголовок, макет, метаданные
`publish_dashboard`	Опубликовать черновик дашборда
`copy_dashboard`	Дублировать дашборд
`delete_dashboard`	Удалить дашборд

Графики

Инструмент	Описание
`list_charts`	Список всех графиков (с опциональным поиском)
`get_chart`	Получить график по ID или UUID
`get_chart_data`	Получить последние данные для графика
`create_chart`	Создать новый график
`update_chart`	Обновить свойства графика
`delete_chart`	Удалить график

Наборы данных

Инструмент	Описание
`list_datasets`	Список всех наборов данных
`get_dataset`	Получить набор данных по ID или UUID
`create_dataset`	Создать из таблицы или SQL-запроса
`get_or_create_dataset`	Получить существующий или создать новый
`refresh_dataset`	Синхронизировать столбцы из исходной таблицы
`update_dataset`	Обновить свойства набора данных
`get_dataset_related_objects`	Посмотреть, какие графики/дашборды его используют
`delete_dataset`	Удалить набор данных

Базы данных

Инструмент	Описание
`list_databases`	Список всех подключений к базам данных
`get_database`	Получить подключение к базе данных по ID
`list_schemas`	Список схем в базе данных
`list_tables`	Список таблиц в схеме
`get_table_metadata`	Получить информацию о столбцах таблицы
`get_select_star`	Получить шаблон SELECT * для таблицы

SQL

Инструмент	Описание
`execute_sql`	Выполнить SQL-запрос и получить результаты
`format_sql`	Красивое форматирование SQL-запроса
`estimate_query_cost`	Оценить стоимость запроса (если поддерживается)
`list_saved_queries`	Список сохраненных SQL-запросов
`save_query`	Сохранить SQL-запрос

Примеры запросов

После подключения к вашему ИИ-ассистенту:

"List all published dashboards"
"Create a new dashboard called 'Sales Overview'"
"Show me all charts in dashboard 11"
"Run a SQL query on database 2: SELECT count() FROM orders"*
"What datasets are used by the 'Revenue' dashboard?"
"Create a bar chart using dataset 5 showing sales by region"

superset-mcp

superset-mcp

Предварительные требования

Настройка (занимает ~1 минуту)

1. Клонируйте репозиторий

2. Настройте учетные данные

3. Проверьте работоспособность

Подключение к вашему ИИ-клиенту

Claude Code

Claude Desktop

Cursor

Доступные инструменты

Дашборды

Графики

Наборы данных

Базы данных

SQL

Примеры запросов

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API