Qlik Sense MCP 服务器

用于 Qlik Sense Enterprise 的模型上下文协议 (Model Context Protocol) 服务器。它将 Qlik 的存储库 (HTTP) 和引擎 (WebSocket) API 公开为 24 个 MCP 工具，以便 LLM 客户端可以通过单一统一接口发现应用程序、检查数据模型、构建超立方体 (hypercubes) 并管理重载任务。

功能概览

完整工具列表及说明：docs/tools.md。

Related MCP server: Opik MCP Server

快速入门

uvx qlik-sense-mcp-server

服务器以 流式 HTTP 模式在 http://127.0.0.1:8000/mcp 上启动。通过环境变量进行配置 — 请参阅 docs/configuration.md。

对于 stdio 模式（传统 MCP 传输），请传递 --stdio。

文档

v1.4.0 系列的关键事实

• 缓存引擎 WebSocket 连接。 一旦打开应用程序，针对同一 app_id 的后续每次工具调用都会重用相同的 WebSocket 和相同的打开文档。切换 app_id 会关闭旧文档并在同一套接字上打开新文档。断开的连接会自动透明地重新打开。实现：engine。实现：[engine_api.py](qlik_sense_mcp_server/engine_api.py) 和 [docs/architecture.md`。

• 默认使用流式 HTTP 传输。 服务器是一个长驻进程；多个 MCP 客户端可以并行与其通信。传统的 stdio 模式仍然可以通过 --stdio 使用。

• tool_call_seconds 作为每个工具响应的第一个键注入 — 以毫秒为单位的调用挂钟时间。使用它来发现缓慢的工具。

• 硬性超立方体限制。 engine_create_hypercube 会立即拒绝 max_rows > 5000 或 columns * max_rows > 9900 的请求，并提供结构化错误和指向集合分析 (set-analysis) 或 Top-N 模式的提示。Qlik 引擎本身对于任何超过 10000 个单元格的单页会返回 错误 7009 calc-pages-too-large。

• 单一超时旋钮。 QLIK_WS_TIMEOUT（默认 180.0 秒）控制 WebSocket 握手和每次引擎 API 调用。

要求

• Python 3.12（该包是针对此版本构建和测试的；请参阅 pyproject.toml）

• Qlik Sense Enterprise（存储库端口 4242，引擎端口 4747 — 标准端口）

• 来自 Qlik Sense 节点的客户端证书、私钥和根 CA

• 从运行此服务器的主机到 Qlik 的网络访问

免责声明

本项目是一个独立的、社区构建的集成。它不隶属于 Qlik Technologies Inc.、QlikTech International AB 或任何其他 Qlik 实体，也不受其认可、赞助或支持。“Qlik”、“Qlik Sense”、“QlikView”及所有相关产品名称均为其各自所有者的商标。

本项目中使用的关于 Qlik Sense API、端口分配、错误代码、协议行为和使用模式的所有信息均完全从公开来源获得 — Qlik 开发者门户 (help.qlik.com, qlik.dev)、Qlik 社区论坛以及其他公开文档。未使用任何专有、机密或逆向工程材料。

许可证

MIT © 2025-2026 Stanislav Chernov