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)：在响应中包含图表元数据
• 返回：带有标题、行和可选元数据的图表数据

配置

创建 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 服务器：

# 构建 Docker 镜像
docker build -t qlik-mcp .

# 运行容器
# 确保首先创建一个 .env 文件（复制自 .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 支持）

本地设置

# 克隆仓库
git clone https://github.com/jwaxman119/qlik-mcp.git
cd qlik-mcp

# 安装依赖项（用于 IDE 支持）
npm install

# 运行服务器
deno task dev

许可证

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

📊 <a name="data-platforms"></a>数据平台

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

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