MCP Connector

Standardize Clinical Data with OMOP Mapping

Map clinical terminology to standardized OMOP concepts using LLMs - validate mappings and search the OMOP vocabulary.


90
Spark score
out of 100
Updated 4 months ago
Version 1.0.0
Models

Add to Favorites

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

01

Map clinical terms to OMOP concepts using LLMs.

02

Validate terminological mappings for accuracy.

03

Search the OMOP vocabulary for relevant concepts.

04

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

find_omop_concept

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 endpoint
  • AZURE_OPENAI_API_KEY - Azure OpenAI API key
  • AZURE_API_VERSION - Azure API version
  • MODEL_NAME - Azure OpenAI model name
  • OPENAI_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.