Qlik MCP Server

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. 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 での使用方法

この MCP サーバーは Docker を使用して実行することもできます：

# 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 とシート 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 に接続し、LLM が SQL クエリを実行したり、ジョブを一覧表示したり、ジョブのステータスを取得したりできるようにします。
• jwaxman19/qlik-mcp 📇 ☁️ - Qlik Cloud API 用の MCP サーバーです。包括的な認証とレート制限のサポートにより、アプリケーションやシートのクエリ、ビジュアライゼーションからのデータ抽出が可能です。
• keboola/keboola-mcp-server - Keboola Connection Data Platform と連携します。このサーバーは、Keboola Storage API のデータを一覧表示および取得するためのツールを提供します。