MCP Loinc

🚀 LOINC API MCP Server

This project offers a modular Python wrapper to interact with the LOINC API and seamlessly integrate it into Claude Desktop via the MCP protocol server interface, enabling intelligent lookup and standardization of medical terms.

🚀 Quick Start

The LOINC MCP Server provides comprehensive interaction with the LOINC API, supporting both online and local database modes of operation. It enables intelligent term processing through Claude Desktop. Here are the main features and operation guides:

✨ Features

1. Modular Python Wrapper: Offers a simple and easy - to - use interface to simplify interaction with the LOINC API.
2. MCP Protocol Integration: Supports docking with Claude Desktop for intelligent retrieval and standardization of medical terms.
3. Dual - mode Operation:
   • Online Mode: Calls the LOINC API in real - time to obtain the latest term data.
   • Local Database Mode: Supports offline environments. Pre - download and store the LOINC database to ensure usability without a network.

📦 Installation

Environment Requirements

• Operating System: Linux, Windows, or macOS
• Python Version: 3.6+

Installation Steps

1. Clone the project repository:

git clone https://github.com/christian-delage/loinc-mcp-server.git
cd loinc-mcp-server

2. Install dependencies:

pip install -r requirements.txt

📚 Documentation

Obtain LOINC API Access

1. Register a LOINC Account: Visit the LOINC official website and create a developer account.
2. Get an API Key: After logging in, go to the developer documentation and apply for an API access key.

Configuration

Set Up Claude Desktop

Add the following content to the configuration file:

{
  "mcp_server": {
    "host": "localhost",
    "port": 5000,
    "timeout": 30
  }
}

Authentication

When running the server, use the following command for authentication:

python loinc_server.py --username your_loinc_username --password your_loinc_password

Available MCP Tools

LOINC Code Search

Supports searching for term information by code or description. Example request:

{
  "query": "hemoglobin",
  "include_details": true,
  "property_filter": "Mass"
}

LOINC Detail Retrieval

Get detailed information for a specific code, for example:

{
  "loinc_code": "2339-0"
}

Panel Information

Supports panel - level term query and management.

Hierarchical Navigation

Displays term relationships through hierarchical data for easy understanding and navigation.

💻 Usage Examples

Basic Usage

{
  "query": "血红蛋白",
  "include_details": true
}

Advanced Usage

{
  "query": "白细胞计数",
  "property_filter": "数量",
  "system_filter": "血液"
}

Troubleshooting

• Empty Results: Confirm that the API Key is valid and the permissions are correct.
• Connection Issues: Check the network status or try changing the network environment.
• Authentication Errors: Re - check the username and password.

Advanced Features

Create a Local Database

python loinc_server.py --create-db --username your_loinc_username --password your_loinc_password

Custom Filters

Supports the following advanced filtering options:

• property_filter: Filter by property.
• system_filter: Filter by system (e.g., blood, body fluid).
• class_filter: Filter by classification (e.g., CHEM, VOL).

Contribution

Contributions are welcome! Please submit Pull Requests or Issues to feedback problems and suggestions.

📄 License

This project is open - source and uses the [LICENSE] license.

Acknowledgments

Thanks to the following institutions and individuals:

• LOINC for providing API support.
• The LOINC team for developing a comprehensive medical term standard.
• Claude AI for enabling intelligent integration features.

Creator: Christian Delage (dr.christian.delage@gmail.com)