Qlik MCP 服务器

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）：在响应中包含图表元数据

• 返回：带有标题、行和可选元数据的图表数据

Related MCP server: MCP Alchemy

设置

创建 Qlik Cloud API 密钥：

1. 登录到您的 Qlik Cloud 租户

2. 导航至“设置”>“API 密钥”

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"
    }
  }
}

与游标一起使用

1. 打开光标设置

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

发展

先决条件

• 德诺

• 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，允许 LLM 运行 SQL 查询、列出作业并获取作业状态。

• jwaxman19/qlik-mcp 📇 ☁️ - Qlik Cloud API 的 MCP 服务器，支持查询应用程序、工作表以及从可视化中提取数据，并提供全面的身份验证和速率限制支持。

• keboola/keboola-mcp-server - 与 Keboola 连接数据平台交互。该服务器提供用于列出和访问 Keboola 存储 API 数据的工具。