Qlik MCP Server

Qlik MCP 服务

用于 Qlik Cloud API 的 MCP 服务，可让 Claude 与 Qlik 应用交互，并从可视化图表中提取数据。

工具

qlik_get_apps

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

• 可选输入：
  • limit（number，默认值：100）：要返回的应用数量上限
  • offset（string）：下一页的分页偏移量
• 返回：包含应用 ID 和信息的应用列表

qlik_get_app_sheets

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

• 可选输入：
  • app_id（string）：Qlik 应用的 ID（默认为 QLIK_APP_ID 环境变量）
• 返回：包含工作表 ID、标题和元数据的工作表列表

qlik_get_sheet_charts

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

• 必需输入：
  • sheet_id（string）：要获取图表的工作表 ID
• 可选输入：
  • app_id（string）：Qlik 应用的 ID（默认为 QLIK_APP_ID 环境变量）
• 返回：包含图表 ID、类型和位置的图表列表

qlik_get_chart_data

获取特定图表中的数据

• 必需输入：
  • sheet_id（string）：包含该图表的工作表 ID
  • chart_id（string）：要获取数据的图表 ID
• 可选输入：
  • app_id（string）：Qlik 应用的 ID（默认为 QLIK_APP_ID 环境变量）
  • max_rows（number，默认值：10000）：要检索的最大总行数
  • page_size（number，默认值：1000）：每次请求的行数
  • include_metadata（boolean，默认值：true）：在响应中包含图表元数据
• 返回：包含表头、行和可选元数据的图表数据

设置

创建 Qlik Cloud API 密钥：

1. 登录 Qlik Cloud 租户
2. 前往 Settings > API keys
3. 创建具有适当访问权限的新 API 密钥
4. 安全保存 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 使用

1. 打开 Cursor 设置
2. 前往 Claude 配置部分
3. 添加新的 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 License 许可。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT License 的条款和条件。详情请参见项目仓库中的 LICENSE 文件。

📊 数据平台

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

• JordiNei/mcp-databricks-server - 连接到 Databricks API，允许大模型运行 SQL 查询、列出作业并获取作业状态。
• jwaxman19/qlik-mcp 📇 ☁️ - 用于 Qlik Cloud API 的 MCP 服务，支持查询应用和工作表，以及从可视化内容中提取数据，并提供全面的身份验证和速率限制支持。
• keboola/keboola-mcp-server - 与 Keboola Connection Data Platform 交互。此服务提供用于列出和访问 Keboola Storage API 中数据的工具。