Qlik Sense MCP 서버

Qlik Sense Enterprise를 위한 Model Context Protocol 서버입니다. Qlik의 Repository(HTTP) 및 Engine(WebSocket) API를 24개의 MCP 도구로 노출하여 LLM 클라이언트가 단일 통합 인터페이스를 통해 앱을 검색하고, 데이터 모델을 검사하며, 하이퍼큐브를 빌드하고, 리로드 작업을 관리할 수 있도록 합니다.

포함된 기능

전체 도구 목록 및 설명: docs/tools.md.

Related MCP server: Opik MCP Server

빠른 시작

uvx qlik-sense-mcp-server

이 서버는 Streamable HTTP 모드에서 http://127.0.0.1:8000/mcp로 시작합니다. 환경 변수를 통해 구성하십시오 — docs/configuration.md를 참조하십시오.

stdio 모드(레거시 MCP 전송)의 경우 --stdio를 전달하십시오.

문서

v1.4.0 라인의 주요 사실

• 캐시된 Engine WebSocket 연결. 앱이 열리면 동일한 app_id에 대한 모든 후속 도구 호출은 동일한 WebSocket과 동일한 열린 문서를 재사용합니다. app_id를 전환하면 이전 문서를 닫고 동일한 소켓에서 새 문서를 엽니다. 끊긴 연결은 투명하게 다시 열립니다. 구현: engine_api.py 및 docs/architecture.md.

• 기본적으로 Streamable HTTP 전송. 서버는 장기 실행 프로세스이며, 여러 MCP 클라이언트가 병렬로 통신할 수 있습니다. 레거시 stdio 모드는 --stdio 뒤에서 여전히 작동합니다.

• **tool_call_seconds**는 모든 도구 응답의 첫 번째 키로 삽입되며, 밀리초 단위의 호출 벽시계 시간입니다. 느린 도구를 찾는 데 사용하십시오.

• 엄격한 하이퍼큐브 제한. engine_create_hypercube는 max_rows > 5000 또는 columns * max_rows > 9900인 요청을 즉시 거부하며, 구조화된 오류와 함께 set-analysis 또는 top-N 패턴을 가리키는 힌트를 제공합니다. Qlik Engine 자체는 10,000셀이 넘는 단일 페이지에 대해 오류 7009 calc-pages-too-large를 반환합니다.

• 단일 타임아웃 노브. QLIK_WS_TIMEOUT(기본값 180.0초)은 WebSocket 핸드셰이크와 모든 Engine API 호출을 모두 제어합니다.

요구 사항

• Python 3.12 (패키지는 이 버전을 기준으로 빌드 및 테스트되었습니다. pyproject.toml 참조)

• Qlik Sense Enterprise (포트 4242의 Repository, 포트 4747의 Engine — 표준 포트)

• Qlik Sense 노드의 클라이언트 인증서, 개인 키 및 루트 CA

• 이 서버를 실행하는 호스트에서 Qlik으로의 네트워크 액세스

면책 조항

이 프로젝트는 독립적인 커뮤니티 빌드 통합입니다. Qlik Technologies Inc., QlikTech International AB 또는 기타 Qlik 법인과 제휴, 보증, 후원 또는 지원을 받지 않습니다. "Qlik", "Qlik Sense", "QlikView" 및 모든 관련 제품 이름은 해당 소유자의 상표입니다.

Qlik Sense API, 포트 할당, 오류 코드, 프로토콜 동작 및 이 프로젝트에서 사용된 사용 패턴에 대한 모든 정보는 공개적으로 사용 가능한 소스(Qlik 개발자 포털(help.qlik.com, qlik.dev), Qlik 커뮤니티 포럼 및 기타 공개 문서)에서만 얻었습니다. 독점적이거나 기밀이거나 리버스 엔지니어링된 자료는 사용되지 않습니다.

라이선스

MIT © 2025-2026 Stanislav Chernov