Qlik数据交互服务

Qlik MCP Server是一个通过API与Qlik Cloud交互的服务,支持从Qlik应用程序和可视化中提取数据。

  • by jwaxman19
  • TypeScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 jwaxman19/qlik-mcp

使用说明

Qlik MCP服务器

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

工具

qlik_get_apps

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

  • 可选输入:
    • limit (数字,默认值:100):要返回的最大应用程序数
    • offset (string):下一页的分页偏移量
  • 返回:应用程序及其ID和信息的列表

qlik_get_app_sheets

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

  • 可选输入:
    • app_id (string):Qlik应用程序的ID(默认为Qlik_APP_ID环境变量)
  • 返回:包含ID、标题和元数据的工作表列表

qlik_get_sheet_carts

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

  • 所需输入:
    • 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 (数字,默认值:10000):要检索的最大总行数
    • page_size (number,默认值:1000):每个请求的行数
    • include_metadata (布尔值,默认值:true):在响应中包含图表元数据
  • 返回:带有标题、行和可选元数据的图表数据

设置

创建Qlik Cloud API密钥:

  1. 登录您的Qlik Cloud租户
  2. 导航到“设置”>“API键”
  3. 创建具有适当访问权限的新API密钥
  4. 安全地保存API密钥

配置环境:

创建一个 .env 使用您的Qlik Cloud凭据文件(请参阅 .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安装路径(通常 ~/.deno/bin/deno 在Unix系统上)以及 /path/to/qlik-mcp 带有克隆存储库的绝对路径。

故障排除

如果遇到错误,请验证:

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

常见问题:

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

发展

先决条件

本地设置

# 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 API,允许LLM运行SQL查询、列出作业并获取作业状态。
  • jwaxman19/qlik-mcp 📇 ☁️ - 用于Qlik Cloud API的MCP服务器,通过全面的身份验证和速率限制支持,可以查询应用程序、工作表和从可视化中提取数据。
  • keboola/keboola mcp服务器 -与Kepoola连接数据平台交互。该服务器提供用于列出和访问Keboola Storage API数据的工具。