LOINC API MCP 服务器

此项目提供了一个模块化的 Python 包装器，用于与 LOINC API 进行交互，并通过 MCP 协议服务器接口无缝集成到 Claude Desktop 中，实现医学术语的智能查找和标准化。

目录

• 概述
• 功能
• 安装
• [获取 LOINC API 访问权限](#获取-loinc-api 访问权限)
• 配置
  • 设置 Claude Desktop
  • 身份验证
• [可用的 MCP 工具](#可用的-mcp 工具)
  • [LOINC 编码搜索](#loinc 编码搜索)
  • [LOINC 详细信息检索](#loinc 详细信息检索)
  • 面板信息
  • 层次结构导航
• 使用示例
• 故障排除
• 高级功能

概览

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"
}

面板信息

支持面板级别的术语查询和管理。

层次结构导航

通过层次化数据展示术语关系，便于理解和导航。

使用示例

1. 基本搜索：

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

2. 高级过滤：

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

故障排除

• 空结果：确认 API Key 有效且权限正确。
• 连接问题：检查网络状态或尝试更换网络环境。
• 认证错误：重新核对用户名和密码。

高级功能

创建本地数据库

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

自定义过滤器

支持以下高级过滤选项：

• property_filter：按属性筛选。
• system_filter：按系统（如血液、体液）筛选。
• class_filter：按分类（如 CHEM、VOL）筛选。

贡献

欢迎贡献！请通过提交 Pull Request 或 Issue 反馈问题和建议。

许可证

本项目开源，采用 [LICENSE] 协议。

致谢

感谢以下机构和个人：

• LOINC 提供 API 支持
• LOINC 团队开发了全面的医学术语标准
• Claude AI 实现了智能集成功能

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