MCP Loinc

🚀 LOINC API MCP 服務器

本項目提供了一個模塊化的 Python 包裝器，用於與 LOINC API 進行交互。它能夠通過 MCP 協議服務器接口無縫集成到 Claude Desktop 中，實現醫學術語的智能查找和標準化，為醫學領域的信息處理提供了便利。

🚀 快速開始

LOINC MCP 服務器提供了對 LOINC API 的全面交互，支持在線與本地數據庫雙模式運行，並通過 Claude Desktop 實現智能術語處理。以下是主要功能和操作指南，幫助你快速上手。

✨ 主要特性

1. 模塊化 Python 包裝器：提供簡潔易用的接口，極大地簡化了與 LOINC API 的交互過程。
2. MCP 協議集成：支持與 Claude Desktop 對接，可實現醫學術語的智能檢索和標準化處理。
3. 雙模式運行：
   • 在線模式：即時調用 LOINC API，能夠獲取最新的術語數據。
   • 本地數據庫模式：支持離線環境，可預先下載並存儲 LOINC 數據庫，確保在無網絡時仍可正常使用。

📦 安裝指南

環境要求

• 操作系統：Linux、Windows 或 macOS
• Python 版本：3.6+

安裝步驟

1. 克隆項目倉庫：

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

2. 安裝依賴項：

pip install -r requirements.txt

📚 詳細文檔

獲取 LOINC API 訪問權限

1. 註冊 LOINC 賬戶：訪問 LOINC 官網，創建開發者賬戶。
2. 獲取 API Key：登錄後進入開發者文檔，申請 API 訪問密鑰。

配置

設置 Claude Desktop

在配置文件中添加以下內容：

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

身份驗證

運行服務器時，使用以下命令進行身份認證：

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

可用的 MCP 工具

LOINC 編碼搜索

支持通過編碼或描述查找術語信息。示例請求：

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

LOINC 詳細信息檢索

獲取特定編碼的詳細信息，例如：

{
  "loinc_code": "2339-0"
}

面板信息

支持面板級別的術語查詢和管理。

層次結構導航

通過層次化數據展示術語關係，便於理解和導航。

故障排除

• 空結果：確認 API Key 有效且權限正確。
• 連接問題：檢查網絡狀態或嘗試更換網絡環境。
• 認證錯誤：重新核對用戶名和密碼。

高級功能

創建本地數據庫

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

自定義過濾器

支持以下高級過濾選項：

• property_filter：按屬性篩選。
• system_filter：按系統（如血液、體液）篩選。
• class_filter：按分類（如 CHEM、VOL）篩選。

💻 使用示例

基礎用法

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

高級用法

{
  "query": "白細胞計數",
  "property_filter": "數量",
  "system_filter": "血液"
}

貢獻

歡迎貢獻！請通過提交 Pull Request 或 Issue 反饋問題和建議。

📄 許可證

本項目開源，採用 [LICENSE] 協議。

致謝

感謝以下機構和個人：

• LOINC 提供 API 支持
• LOINC 團隊開發了全面的醫學術語標準
• Claude AI 實現了智能集成功能

創建者：Christian Delage（dr.christian.delage@gmail.com）