Qlik Sense MCP Server

PyPI version PyPI downloads License: MIT Python versions

Сервер Model Context Protocol для Qlik Sense Enterprise. Предоставляет доступ к API репозитория (HTTP) и движка (WebSocket) Qlik в виде 24 инструментов MCP, чтобы клиент LLM мог находить приложения, анализировать модели данных, создавать гиперкубы и управлять задачами перезагрузки через единый унифицированный интерфейс.

Что входит в комплект

Область	Инструменты	Используется для
Репозиторий (приложения и метаданные)	`get_about`, `get_apps`, `get_app_details`	Поиск приложений, получение списка таблиц и полей с их мощностью
Движок (данные и скрипты)	`get_app_script`, `get_app_variables`, `get_app_sheets`, `get_app_sheet_objects`, `get_app_object`, `get_app_field`, `engine_get_field_range`, `get_app_field_statistics`, `engine_create_hypercube`	Чтение скрипта загрузки, получение списка визуализаций, запрос значений полей, создание гиперкубов
Задачи перезагрузки	`get_tasks`, `get_task_details`, `get_task_dependencies`, `get_task_schedule`, `get_task_executions`, `get_task_script_log`, `get_failed_tasks_with_logs`, `start_task`, `create_task`, `update_task`, `delete_task`, `create_task_schedule`	Просмотр, запуск и управление задачами перезагрузки

Полный список с описаниями: docs/tools.md.

Related MCP server: Opik MCP Server

Быстрый старт

uvx qlik-sense-mcp-server

Сервер запускается в режиме Streamable HTTP на http://127.0.0.1:8000/mcp. Настройте его с помощью переменных окружения — см. docs/configuration.md.

Для режима stdio (устаревший транспорт MCP) используйте --stdio.

Документация

Документ	Содержание
`docs/installation.md`	Требования, установка через `uvx` / `pip` / исходный код, настройка сертификатов
`docs/configuration.md`	Все переменные окружения `QLIK_*`, пример `.env`, фрагмент конфигурации клиента MCP
`docs/usage.md`	Транспорты, команды запуска сервера, рекомендуемый порядок вызовов, жесткие ограничения сервера
`docs/tools.md`	Инвентарь всех 24 инструментов, конверт ответа/ошибки, категории ошибок
`docs/architecture.md`	Структура проекта, компоненты, кэширование соединений, строгое сопоставление ID, двухуровневый тайм-аут
`docs/development.md`	Цели `make`, тесты, версионирование, как добавить новый инструмент
`docs/troubleshooting.md`	Распространенные ошибки, сбои планирования гиперкубов, подробное логирование, самопроверка конфигурации
`CHANGELOG.md`	Примечания к выпуску

Ключевые факты о версии v1.4.0

Кэшированные WebSocket-соединения с движком. После открытия приложения каждый последующий вызов инструмента для того же app_id повторно использует тот же WebSocket и тот же открытый документ. Переключение app_id закрывает старый документ и открывает новый в том же сокете. Разорванные соединения восстанавливаются прозрачно. Реализация: engine_api.py и docs/architecture.md.
Транспорт Streamable HTTP по умолчанию. Сервер является долгоживущим процессом; несколько клиентов MCP могут взаимодействовать с ним параллельно. Устаревший режим stdio по-прежнему работает через --stdio.
tool_call_seconds добавляется как первый ключ в каждый ответ инструмента — время выполнения вызова в миллисекундах. Используйте его для поиска медленных инструментов.
Жесткие ограничения гиперкуба. engine_create_hypercube немедленно отклоняет запросы с max_rows > 5000 или columns * max_rows > 9900, возвращая структурированную ошибку с подсказкой по использованию set-analysis или паттернов top-N. Сам движок Qlik возвращает ошибку 7009 calc-pages-too-large для любой страницы размером более 10000 ячеек.
Единый регулятор тайм-аута. QLIK_WS_TIMEOUT (по умолчанию 180.0 секунд) управляет как рукопожатием WebSocket, так и каждым вызовом API движка.

Требования

Python 3.12 (пакет собран и протестирован с этой версией; см. pyproject.toml)
Qlik Sense Enterprise (репозиторий на порту 4242, движок на порту 4747 — стандартные порты)
Клиентский сертификат, закрытый ключ и корневой CA от узла Qlik Sense
Сетевой доступ от хоста, на котором запущен этот сервер, к Qlik

Отказ от ответственности

Этот проект является независимой интеграцией, созданной сообществом. Он НЕ связан, не одобрен, не спонсируется и не поддерживается Qlik Technologies Inc., QlikTech International AB или любой другой организацией Qlik. "Qlik", "Qlik Sense", "QlikView" и все связанные названия продуктов являются товарными знаками соответствующих владельцев.

Вся информация об API Qlik Sense, распределении портов, кодах ошибок, поведении протокола и шаблонах использования, применяемая в этом проекте, была получена исключительно из общедоступных источников — портала разработчиков Qlik (help.qlik.com, qlik.dev), форумов Qlik Community и другой публичной документации. Проприетарные, конфиденциальные или полученные путем обратной разработки материалы не используются.

Qlik Sense MCP Server

Qlik Sense MCP Server

Что входит в комплект

Быстрый старт

Документация

Ключевые факты о версии v1.4.0

Требования

Отказ от ответственности

Лицензия

Resources

Tools

Latest Blog Posts

MCP directory API