LOINC API MCP 服务器

该项目提供了一个模块化的Python封装器，用于LOINC API，并通过一个MCP服务器接口与Claude Desktop无缝集成，实现智能医学术语查询和标准化。

目录

• 概述
• 特性
• 安装
• 获取LOINC API访问权限
• 配置
  • 设置Claude Desktop
  • 认证
• 可用的MCP工具
  • LOINC代码搜索
  • LOINC详情检索
  • 面板信息
  • 层次导航
• 使用示例
• 故障排除
• 高级功能

概述

LOINC MCP服务器提供了对逻辑观察标识符名称和代码（LOINC）API服务的全面接口，允许您：

• 使用各种术语和过滤器搜索LOINC代码
• 获取特定LOINC代码的详细信息
• 访问标准化的面板和表单
• 导航LOINC术语之间的层级关系
• 获取LOINC观察结果的标准答案列表

结构组织如下：

• loinc_api/ - LOINC API交互的主要包
  • __init__.py - 包初始化
  • config.py - 配置设置
  • api.py - 主API客户端，带有HTTP基本认证
  • database.py - 本地数据库处理程序，用于离线访问

特性

• 全面的LOINC搜索：使用自由文本查询并带有过滤选项（如组件、属性、系统和类别）来查找LOINC代码
• 详细的LOINC信息：访问任何LOINC代码的完整细节，包括正式名称、组件、属性、系统、方法等
• 面板结构访问：探索LOINC面板及其组件测试
• 层次导航：导航LOINC术语之间的父子关系
• 标准化表单：访问LOINC的标准化评估表单和问卷
• Top 2000访问：检索最常用的LOINC代码
• 答案列表：获取特定LOINC观察结果的标准答案列表
• 双模式操作：可以使用在线LOINC API或本地数据库文件进行工作
• MCP集成：通过MCP协议与Claude Desktop无缝集成

安装

1. 克隆仓库：

   git clone https://github.com/yourusername/loinc-api.git
   cd loinc-api
   

2. 安装所需依赖项：

   pip install -r requirements.txt
   

获取LOINC API访问权限

要使用LOINC API，您需要：

1. 在LOINC.org注册免费账户
2. 接受使用条款
3. 注册后，您可以使用您的LOINC.org用户名和密码进行API认证

配置

设置Claude Desktop

为了与Claude Desktop集成，请在您的Claude Desktop配置文件中添加以下配置：

{
  "mcp_servers": [
    {
      "name": "LOINC API",
      "url": "http://localhost:8080",
      "auth": {
        "type": "basic",
        "username": "your_loinc_username",
        "password": "your_loinc_password"
      }
    }
  ]
}

认证

LOINC API使用HTTP基本认证。启动服务器时，您需要提供您的LOINC用户名和密码：

python loinc_server.py --username=your_loinc_username --password=_your_loinc_password

可用的MCP工具

LOINC代码搜索

使用各种过滤器搜索LOINC代码：

{
  "query": "葡萄糖",
  "limit": 10,
  "component_filter": "葡萄糖",
  "system_filter": "血液",
  "include_details": true
}

LOINC详情检索

获取特定LOINC代码的综合信息：

{
  "loinc_code": "2339-0"
}

面板信息

检索LOINC面板的结构：

{
  "loinc_code": "24331-1"
}

层次导航

探索父子关系：

{
  "parent": "LP7839-6"
}

使用示例

示例1：搜索与葡萄糖相关的LOINC代码

{
  "query": "葡萄糖",
  "limit": 5,
  "include_details": true
}

示例2：获取特定LOINC代码的详细信息

{
  "loinc_code": "2339-0"
}

故障排除

• 空结果：确保您的LOINC账户具有适当的权限，并且您正在使用正确的身份验证凭据
• 连接问题：检查您的互联网连接并确认LOINC API可访问
• 身份验证错误：确认您的LOINC用户名和密码正确

高级功能

• 本地数据库：为了离线使用，您可以创建一个本地LOINC数据库文件：

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

• 自定义过滤：应用高级过滤器以缩小搜索结果：

  {
    "query": "血红蛋白",
    "property_filter": "质量",
    "system_filter": "血液",
    "class_filter": "CHEM"
  }
  

贡献

欢迎贡献以改进LOINC MCP服务器！请随意提交拉取请求或打开问题报告错误和功能请求。

许可

本项目开源

致谢

• LOINC提供API
• LOINC团队提供全面的医学术语标准化
• Claude AI提供智能集成能力

由Christian delage创建 (dr.christian.delage@gmail.com)