MCP Loinc

LOINC API MCP服务器

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

目录

• 概述
• 特性
• 安装
• 获取LOINC API访问权限
• 配置

- 设置Claude桌面 - 认证

• 可用的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的标准化评估表格和问卷
• 前2000名访问：检索最常用的LOINC代码
• 答案列表：获取特定LOINC观察的标准化答案列表
• 双模式操作：使用在线LOINC API或本地数据库文件
• MCP集成：通过MCP协议与Claude Desktop无缝集成

安装

1. 克隆存储库：

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

1. 安装所需的依赖项：

   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)