LOINC API MCP 服务器

本项目提供了一个模块化的 LOINC API Python 封装器，带有一个 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 - 带有 HTTP 基本身份验证的主 API 客户端
  • 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": "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 服务器！ 请随时提交拉取请求或打开问题以报告错误和提出功能请求。

许可证

本项目是开源的

致谢

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

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