Architecture
Understanding the components that power CQL Studio
Core Components
Web Interface
Modern, browser-based tools and integrated development environment (IDE) for writing, editing, testing, and publishing CQL code. Provides syntax highlighting, autocomplete, and real-time validation.
CQL Translator
Translates CQL code into executable formats. Handles parsing, validation, and conversion of CQL expressions into various target representations.
Data & CQL Server
FHIR resource server providing persistent storage and retrieval of clinical data and CQL execution capabilities. Manages data retrieval, CQL compilation, and query processing.
Terminology Server
FHIR resource server providing access to healthcare terminologies, value sets, and code systems. Supports standard terminologies like SNOMED CT, LOINC, and ICD-10. Content is customizable and can be replaced with a custom terminology server.
AI/LLM Integration
Optional AI assistance via the Ollama model runner and integrated Model Context Protocol (MCP) services. Language model for code generation and assistance can be replaced with a custom model.
Engine Test Runner
Comprehensive testing framework for testing CQL engine implementations against official HL7 test cases. Provides detailed test report data and visualization tools for cross-comparison to other engines. Test runner can be pointed at any network-accessible CQL engine implementation.
Configuration & Integration
CQL Studio is designed with flexibility in mind. Each component can be configured or replaced to meet your organization's specific needs, security requirements, and infrastructure constraints.
Connect to your own FHIR servers, databases, or data warehouses
Choose from any MCP-compatible language model or deploy your own
Run locally, on-premises, or in cloud environments
Plugin system for custom functionality and integrations