LOINC API MCP Server

LOINC API MCP 服务

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

目录

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

概述

LOINC MCP 服务提供了一个全面的接口，用于访问 Logical Observation Identifiers Names and Codes（LOINC）API 服务，可用于：

• 根据各种术语和筛选条件搜索 LOINC 代码
• 获取特定 LOINC 代码的详细信息
• 访问标准化面板和表单
• 浏览 LOINC 术语之间的层级关系
• 获取 LOINC 观测项目的答案列表

项目结构如下：

• loinc_api/ - 用于与 LOINC API 交互的主程序包
  • __init__.py - 程序包初始化
  • config.py - 配置设置
  • api.py - 采用 HTTP Basic Authentication 的主 API 客户端
  • database.py - 用于离线访问的本地数据库处理程序

功能

• 全面的 LOINC 搜索：使用自由文本查询查找 LOINC 代码，并可按 component、property、system 和 class 筛选
• 详细的 LOINC 信息：获取任意 LOINC 代码的完整详情，包括正式名称、component、property、system、method 等
• 面板结构访问：查看 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 Basic Authentication。启动服务时，需要提供您的 LOINC 用户名和密码：

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

可用的 MCP 工具

LOINC 代码搜索

使用各种筛选条件搜索 LOINC 代码：

{
  "query": "glucose",
  "limit": 10,
  "component_filter": "Glucose",
  "system_filter": "Blood",
  "include_details": true
}

获取 LOINC 详情

获取特定 LOINC 代码的全面信息：

{
  "loinc_code": "2339-0"
}

面板信息

获取 LOINC 面板的结构：

{
  "loinc_code": "24331-1"
}

层级导航

浏览父子关系：

{
  "parent": "LP7839-6"
}

使用示例

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

{
  "query": "glucose",
  "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": "hemoglobin",
    "property_filter": "Mass",
    "system_filter": "Blood",
    "class_filter": "CHEM"
  }
  

贡献

欢迎为改进 LOINC MCP Server 做出贡献！欢迎提交拉取请求，或针对错误和功能请求创建问题。

许可证

本项目为开源项目

致谢

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

由 Christian delage 创建（[email protected]）