omop_mcp

omop_mcp

LLM-powered server for mapping clinical terms to OMOP concepts using the Model Context Protocol.

4
Stars
1
Forks
4
Watchers
0
Issues
OMOP MCP Server implements the Model Context Protocol (MCP) for mapping clinical terminology to OMOP standard concepts using Large Language Models. It provides tools for validating and searching OMOP vocabularies, supporting terminology conversion and enhancing mapping accuracy through context-aware prompts. Configuration support for integration with Claude Desktop and preference for specific vocabularies is included. The server offers detailed mapping responses to streamline medical data standardization.

Key Features

Model Context Protocol (MCP) server implementation
Mapping clinical terminology to OMOP concepts
Context-aware prompt processing
Configurable integration with Claude Desktop
Validation of terminology mapping
Searching OMOP vocabulary databases
Conversion between clinical coding systems
Support for preferred vocabularies
Detailed, explainable mapping responses
Sample configuration and usage examples

Use Cases

Automated mapping of clinical terms to OMOP concepts
Standardizing medical concepts across diverse datasets
Integrating with conversational AI or LLM-based clinical workflows
Searching OMOP vocabularies for research or clinical applications
Converting clinical codes between different systems (e.g., SNOMED, LOINC, RxNorm)
Validating existing clinical term mappings
Supporting clinical data harmonization in research studies
Configuring personalized mapping priorities based on preferred vocabularies
Assisting clinical informatics teams in data migration
Improving accuracy and consistency in electronic health record standardization

README

OMOP MCP Server

Model Context Protocol (MCP) server for mapping clinical terminology to Observational Medical Outcomes Partnership (OMOP) concepts using Large Language Models (LLMs).

Configuration for Claude Desktop

Add the following configuration to your claude_desktop_config.json file:

Location:

  • MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuration:

json
{
  "mcpServers": {
    "omop_mcp": {
      "command": "uv",
      "args": ["--directory", "<path-to-local-repo>", "run", "omop_mcp"]
    }
  }
}

Features

The OMOP MCP server provides the find_omop_concept tool for:

  • Mapping clinical terminology to OMOP concepts
  • Validating terminology mappings
  • Searching OMOP vocabulary
  • Converting between different clinical coding systems

Usage Example

  • It is recommended to specify the OMOP field and table name in the prompt for improved accuracy. Refer to omop_concept_id_fields.json for the list of OMOP fields and tables that store concept IDs.

  • You can specify preferred vocabularies for the mapping in order of priority (e.g., "SNOMED preferred" or "LOINC > SNOMED > RxNorm").

Prompt: "Map Temperature Temporal Scanner - RR for measurement_concept_id in the measurement table."

Response:

CONCEPT_ID: 46235152
CODE: 75539-7
NAME: Body temperature - Temporal artery
CLASS: Clinical Observation
CONCEPT: Standard
VALIDITY: Valid
DOMAIN: Measurement
VOCAB: LOINC
URL: https://athena.ohdsi.org/search-terms/terms/46235152
REASON: This LOINC concept specifically represents body temperature measured at the temporal artery, which is what a temporal scanner measures. The "RR" in your source term likely refers to "Recovery Room" or another location/department indicator, but in OMOP, the location would typically be captured in a separate field rather than as part of the measurement concept itself.

Pre-print at arXiv (cs.AI):

An Agentic Model Context Protocol Framework for Medical Concept Standardization

License

This project is licensed under the Apache License 2.0. See LICENSE file for details.

Contact: jaerongahn@gmail.com

Star History

Star History Chart

Repository Owner

OHNLP
OHNLP

Organization

Repository Details

Language Python
Default Branch main
Size 297 KB
Contributors 1
License Other
MCP Verified Sep 5, 2025

Programming Languages

Python
76.96%
Jupyter Notebook
22.57%
Dockerfile
0.47%

Topics

ai-agents healthcare mcp-server ohdsi omop-cdm

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • awslabs/mcp

    awslabs/mcp

    Specialized MCP servers for seamless AWS integration in AI and development environments.

    AWS MCP Servers is a suite of specialized servers implementing the open Model Context Protocol (MCP) to bridge large language model (LLM) applications with AWS services, tools, and data sources. It provides a standardized way for AI assistants, IDEs, and developer tools to access up-to-date AWS documentation, perform cloud operations, and automate workflows with context-aware intelligence. Featuring a broad catalog of domain-specific servers, quick installation for popular platforms, and both local and remote deployment options, it enhances cloud-native development, infrastructure management, and workflow automation for AI-driven tools. The project includes Docker, Lambda, and direct integration instructions for environments such as Amazon Q CLI, Cursor, Windsurf, Kiro, and VS Code.

    • 6,220
    • MCP
    • awslabs/mcp
  • cloudflare/mcp-server-cloudflare

    cloudflare/mcp-server-cloudflare

    Connect Cloudflare services to Model Context Protocol (MCP) clients for AI-powered management.

    Cloudflare MCP Server enables integration between Cloudflare's suite of services and clients using the Model Context Protocol (MCP). It provides multiple specialized servers that allow AI models to access, analyze, and manage configurations, logs, analytics, and other features across Cloudflare's platform. Users can leverage natural language interfaces in compatible MCP clients to read data, gain insights, and perform automated actions on their Cloudflare accounts. This project aims to streamline the orchestration of security, development, monitoring, and infrastructure tasks through standardized MCP connections.

    • 2,919
    • MCP
    • cloudflare/mcp-server-cloudflare
  • OpenMCP

    OpenMCP

    A standard and registry for converting web APIs into MCP servers.

    OpenMCP defines a standard for converting various web APIs into servers compatible with the Model Context Protocol (MCP), enabling efficient, token-aware communication with client LLMs. It also provides an open-source registry of compliant servers, allowing clients to access a wide array of external services. The platform supports integration with local and remote hosting environments and offers tools for configuring supported clients, such as Claude desktop and Cursor. Comprehensive guidance is offered for adapting different API formats including REST, gRPC, GraphQL, and more into MCP endpoints.

    • 252
    • MCP
    • wegotdocs/open-mcp
  • mcpmcp-server

    mcpmcp-server

    Seamlessly discover, set up, and integrate MCP servers with AI clients.

    mcpmcp-server enables users to discover, configure, and connect MCP servers with preferred clients, optimizing AI integration into daily workflows. It supports streamlined setup via JSON configuration, ensuring compatibility with various platforms such as Claude Desktop on macOS. The project simplifies the connection process between AI clients and remote Model Context Protocol servers. Users are directed to an associated homepage for further platform-specific guidance.

    • 17
    • MCP
    • glenngillen/mcpmcp-server
  • mcp

    mcp

    Universal remote MCP server connecting AI clients to productivity tools.

    WayStation MCP acts as a remote Model Context Protocol (MCP) server, enabling seamless integration between AI clients like Claude or Cursor and a wide range of productivity applications, such as Notion, Monday, Airtable, Jira, and more. It supports multiple secure connection transports and offers both general and user-specific preauthenticated endpoints. The platform emphasizes ease of integration, OAuth2-based authentication, and broad app compatibility. Users can manage their integrations through a user dashboard, simplifying complex workflow automations for AI-powered productivity.

    • 27
    • MCP
    • waystation-ai/mcp
  • mcp-server-templates

    mcp-server-templates

    Deploy Model Context Protocol servers instantly with zero configuration.

    MCP Server Templates enables rapid, zero-configuration deployment of production-ready Model Context Protocol (MCP) servers using Docker containers and a comprehensive CLI tool. It provides a library of ready-made templates for common integrations—including filesystems, GitHub, GitLab, and Zendesk—and features intelligent caching, smart tool discovery, and flexible configuration options via JSON, YAML, environment variables, or CLI. Perfect for AI developers, data scientists, and DevOps teams, it streamlines the process of setting up and managing MCP servers and has evolved into the MCP Platform for enhanced capabilities.

    • 5
    • MCP
    • Data-Everything/mcp-server-templates
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results