Qlik云连接器

@jwaxman19/qlik-mcp

0 Stars 297 次浏览 jwaxman19 更新于 2026-08-23

通过 Qlik Cloud API，使 Claude 能够与 Qlik Cloud 应用程序交互，并从可视化图表中提取数据。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "qlik": {
      "args": [
        "tsx",
        "src/index.ts"
      ],
      "command": "npx",
      "cwd": "/path/to/qlik-mcp",
      "env": {
        "QLIK_API_KEY": "your_api_key_here",
        "QLIK_APP_ID": "your_default_app_id",
        "QLIK_BASE_URL": "your_tenant_url"
      }
    }
  }
}

该服务需要配置环境变量：MAX_RETRIES、MAX_ROWS_PER_REQUEST、MAX_TOTAL_ROWS、QLIK_API_KEY、QLIK_APP_ID、QLIK_BASE_URL、REQUEST_DELAY_MS、RETRY_DELAY_MS

服务介绍

Qlik MCP Server

用于 Qlik Cloud API 的 MCP 服务器，使 Claude 能够与 Qlik 应用程序交互并从可视化中提取数据。

工具

qlik_get_apps

列出工作区中所有可用的 Qlik 应用程序

可选输入：
- limit (数字，默认值：100)：返回的最大应用程序数量
- offset (字符串)：下一页的分页偏移量
返回：带有其 ID 和信息的应用程序列表

qlik_get_app_sheets

获取 Qlik 应用程序中的所有工作表

可选输入：
- app_id (字符串)：Qlik 应用程序的 ID（默认为环境变量 QLIK_APP_ID）
返回：带有其 ID、标题和元数据的工作表列表

qlik_get_sheet_charts

获取特定工作表中的所有图表

必需输入：
- sheet_id (字符串)：要从中获取图表的工作表 ID
可选输入：
- app_id (字符串)：Qlik 应用程序的 ID（默认为环境变量 QLIK_APP_ID）
返回：带有其 ID、类型和位置的图表列表

qlik_get_chart_data

从特定图表中获取数据

必需输入：
- sheet_id (字符串)：包含图表的工作表 ID
- chart_id (字符串)：要从中获取数据的图表 ID
可选输入：
- app_id (字符串)：Qlik 应用程序的 ID（默认为环境变量 QLIK_APP_ID）
- max_rows (数字，默认值：10000)：要检索的最大行数
- page_size (数字，默认值：1000)：每次请求的行数
- include_metadata (布尔值，默认值：true)：在响应中包含图表元数据
返回：带有标题、行和可选元数据的图表数据

设置

创建 Qlik Cloud API 密钥：

登录到您的 Qlik Cloud 租户
导航至设置 > API 密钥
创建一个具有适当访问权限的新 API 密钥
安全保存 API 密钥

配置环境：

创建一个包含您的 Qlik Cloud 凭据的 .env 文件（请参阅 .env.example 以获取模板）：

QLIK_API_KEY=your_api_key_here
QLIK_BASE_URL=your_tenant_url
QLIK_APP_ID=your_default_app_id
MAX_ROWS_PER_REQUEST=1000
MAX_TOTAL_ROWS=10000
REQUEST_DELAY_MS=100
MAX_RETRIES=3
RETRY_DELAY_MS=1000

使用 Docker

您也可以使用 Docker 运行此 MCP 服务器：

# Build the Docker image
docker build -t qlik-mcp .

# Run the container
# Make sure to create a .env file first (copy from .env.example)
docker run --env-file .env qlik-mcp

使用 Claude Desktop

将以下内容添加到您的 claude_desktop_config.json 中：

使用 Deno（推荐）

{
  "mcpServers": {
    "qlik": {
      "command": "/path/to/deno",
      "args": ["run", "--allow-all", "--env-file=.env", "src/index.ts"],
      "cwd": "/path/to/qlik-mcp"
    }
  }
}

使用 Node.js

{
  "mcpServers": {
    "qlik": {
      "command": "npx",
      "args": ["tsx", "src/index.ts"],
      "env": {
        "QLIK_API_KEY": "your_api_key_here",
        "QLIK_BASE_URL": "your_tenant_url",
        "QLIK_APP_ID": "your_default_app_id"
      },
      "cwd": "/path/to/qlik-mcp"
    }
  }
}

使用 Cursor

打开 Cursor 设置
导航到 Claude 配置部分
添加一个新的 MCP 配置：

{
  "name": "Qlik Cloud",
  "command": "/path/to/deno",
  "args": ["run", "--allow-all", "--env-file=.env", "src/index.ts"],
  "cwd": "/path/to/qlik-mcp"
}

将 /path/to/deno 替换为您的 Deno 安装路径（通常在 Unix 系统上为 ~/.deno/bin/deno），并将 /path/to/qlik-mcp 替换为您克隆仓库的绝对路径。

故障排除

如果遇到错误，请验证：

您的 API 密钥具有必要的权限
租户 URL 正确且可访问
应用程序 ID 存在且可访问
环境变量已正确设置
速率限制设置适合您的租户

常见问题：

401 Unauthorized：检查您的 API 密钥
403 Forbidden：验证 API 密钥权限
429 Too Many Requests：调整速率限制设置
404 Not Found：验证应用程序和工作表 ID

开发

前提条件

Deno
Node.js (可选，用于IDE支持)

本地设置

# Clone repository
git clone https://github.com/jwaxman19/qlik-mcp.git
cd qlik-mcp

# Install dependencies (for IDE support)
npm install

# Run server
deno task dev

许可证

此MCP服务器根据MIT许可证发布。这意味着您可以自由使用、修改和分发该软件，但需遵守MIT许可证的条款和条件。更多详情，请参见项目仓库中的LICENSE文件。

📊 数据平台

用于数据集成、转换和管道编排的数据平台。

JordiNei/mcp-databricks-server - 连接到Databricks API，允许LLMs执行SQL查询、列出作业并获取作业状态。
jwaxman19/qlik-mcp 📇 ☁️ - 针对Qlik Cloud API的MCP服务器，支持查询应用程序、表格，并从可视化中提取数据，提供全面的身份验证和速率限制支持。
keboola/keboola-mcp-server - 与Keboola Connection数据平台交互。此服务器提供了工具，用于从Keboola存储API中列出和访问数据。

查看源码项目主页