Standardize Clinical Data with OMOP Mapping
Map clinical terminology to standardized OMOP concepts using LLMs - validate mappings and search the OMOP vocabulary.
Why it matters
Leverage LLMs to map clinical terminology to OMOP concepts, standardizing medical data for analysis. This asset validates mappings and searches the OMOP vocabulary.
Outcomes
What it gets done
Map clinical terms to OMOP concepts using LLMs.
Validate terminological mappings for accuracy.
Search the OMOP vocabulary for relevant concepts.
Convert between different clinical coding systems.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-omop-mcp | bash Capabilities
Tools your agent gets
Maps clinical terminology to OMOP concepts and searches the OMOP vocabulary for standardized medical data.
Overview
OMOP MCP Server
OMOP MCP Server uses an LLM to map clinical terminology to standardized OMOP concepts, validate mappings, search the OMOP vocabulary, and convert between coding systems like SNOMED, LOINC, and RxNorm. Use it when standardizing clinical terms into OMOP concepts for a specific field/table. Requires Azure OpenAI or OpenAI API credentials configured to perform the LLM-based mapping.
What it does
OMOP MCP Server maps clinical terminology to Observational Medical Outcomes Partnership (OMOP) concepts using large language models, helping standardize medical data across different clinical coding systems (like SNOMED, LOINC, and RxNorm).
When to use - and when NOT to
Use it when you need to convert a clinical term (a lab test name, measurement label, or diagnosis description) into its corresponding standardized OMOP concept for a specific OMOP table and field - for example, mapping "Temperature Temporal Scanner - RR" to a measurement_concept_id. Specifying the target field and OMOP table name in your prompt improves mapping accuracy; refer to omop_concept_id_fields.json in the repo for the list of OMOP fields and tables that store concept identifiers. You can also specify a preferred vocabulary priority order (e.g., "SNOMED preferred" or "LOINC > SNOMED > RxNorm"). Do not use it without an LLM backend configured - it requires either Azure OpenAI or OpenAI API credentials to perform the mapping.
Capabilities
find_omop_concept: maps clinical terminology to OMOP concepts, validates terminological mappings, searches the OMOP vocabulary, and converts between different clinical coding systems.
How to install
git clone https://github.com/OHNLP/omop_mcp.git
cd omop_mcp
Requires the uv package manager. Configure Claude Desktop:
{
"mcpServers": {
"omop_mcp": {
"command": "uv",
"args": ["--directory", "<path-to-local-repo>", "run", "omop_mcp"]
}
}
}
Set API credentials via environment variables, either Azure OpenAI (AZURE_OPENAI_ENDPOINT, AZURE_OPENAI_API_KEY, AZURE_API_VERSION, MODEL_NAME) or OpenAI (OPENAI_API_KEY) as an alternative.
Who it's for
Healthcare informaticists and researchers working with OMOP Common Data Model datasets who need to standardize clinical terminology into OMOP concepts for observational research or data harmonization.
Source README
MCP server for mapping clinical terminology to Observational Medical Outcomes Partnership (OMOP) concepts using large language models for standardizing medical data.
Installation
From Source Code
git clone https://github.com/OHNLP/omop_mcp.git
cd omop_mcp
Configuration
Claude Desktop
{
"mcpServers": {
"omop_mcp": {
"command": "uv",
"args": ["--directory", "<path-to-local-repo>", "run", "omop_mcp"]
}
}
}
Available Tools
| Tool | Description |
|---|---|
find_omop_concept |
Maps clinical terminology to OMOP concepts, validates terminological mappings, searches the OMOP vocabulary... |
Features
- Mapping clinical terminology to OMOP concepts
- Validation of terminological mappings
- Searching the OMOP vocabulary
- Conversion between different clinical coding systems
Environment Variables
Optional
AZURE_OPENAI_ENDPOINT- Azure OpenAI service endpointAZURE_OPENAI_API_KEY- Azure OpenAI API keyAZURE_API_VERSION- Azure API versionMODEL_NAME- Azure OpenAI model nameOPENAI_API_KEY- OpenAI API key (alternative to Azure)
Usage Examples
Map `Temperature Temporal Scanner - RR` for `measurement_concept_id` in the `measurement` table.
Map clinical terms with preferred vocabularies in order of priority (e.g., "SNOMED preferred" or "LOINC > SNOMED > RxNorm")
Notes
Requires the uv package manager. It is recommended to specify the field and OMOP table name in prompts to improve accuracy. Refer to omop_concept_id_fields.json for a list of OMOP fields and tables that store concept identifiers. Environment variables are only needed for API calls.
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.