AI导哈

LOINC API 医疗术语查询工具

一个提供LOINC API接口的Python封装工具，支持医疗术语查询、标准化和与Claude Desktop的智能集成。

  • by Kryzo
  • Python
  • 本地部署
  • 12 星标
  • 更新于
在 GitHub 查看 Kryzo/mcp-Loinc

使用说明

LOINC API MCP服务器

该项目为LOINC API提供了一个模块化Python包装器，带有一个MCP服务器接口，该接口与Claude Desktop无缝集成，用于智能医学术语查找和标准化。

目录

概述

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的标准化评估表格和问卷
  • 前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桌面

要与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服务器做出贡献！请随时提交pull请求或打开bug和功能请求的问题。

许可证

这个项目是开源的

致谢

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

由克里斯蒂安·德莱奇创作(dr.christian.delage@gmail.com)

相关 MCP