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 文件：

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

与 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/jwaxman19/qlik-mcp.git
cd qlik-mcp

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

# 运行服务器
deno task dev

许可证

此 MCP 服务器是在 MIT 许可证下授权的。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。