金大哥 - mcp-Loinc MCP 详情

article

README

🚀 LOINC API MCP 服务器

本项目提供了一个模块化的 Python 包装器，用于与 LOINC API 进行交互。它能够通过 MCP 协议服务器接口无缝集成到 Claude Desktop 中，实现医学术语的智能查找和标准化，为医学领域的信息处理提供了便利。

🚀 快速开始

LOINC MCP 服务器提供了对 LOINC API 的全面交互，支持在线与本地数据库双模式运行，并通过 Claude Desktop 实现智能术语处理。以下是主要功能和操作指南，帮助你快速上手。

✨ 主要特性

模块化 Python 包装器：提供简洁易用的接口，极大地简化了与 LOINC API 的交互过程。
MCP 协议集成：支持与 Claude Desktop 对接，可实现医学术语的智能检索和标准化处理。
双模式运行：
- 在线模式：实时调用 LOINC API，能够获取最新的术语数据。
- 本地数据库模式：支持离线环境，可预先下载并存储 LOINC 数据库，确保在无网络时仍可正常使用。

📦 安装指南

环境要求

操作系统：Linux、Windows 或 macOS
Python 版本：3.6+

安装步骤

克隆项目仓库：

git clone https://github.com/christian-delage/loinc-mcp-server.git
cd loinc-mcp-server

安装依赖项：

pip install -r requirements.txt

📚 详细文档

获取 LOINC API 访问权限

注册 LOINC 账户：访问 LOINC 官网，创建开发者账户。
获取 API Key：登录后进入开发者文档，申请 API 访问密钥。

配置

设置 Claude Desktop

在配置文件中添加以下内容：

{
  "mcp_server": {
    "host": "localhost",
    "port": 5000,
    "timeout": 30
  }
}

身份验证

运行服务器时，使用以下命令进行身份认证：

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

可用的 MCP 工具

LOINC 编码搜索

支持通过编码或描述查找术语信息。示例请求：

{
  "query": "hemoglobin",
  "include_details": true,
  "property_filter": "Mass"
}

LOINC 详细信息检索

获取特定编码的详细信息，例如：

{
  "loinc_code": "2339-0"
}

面板信息

支持面板级别的术语查询和管理。

层次结构导航

通过层次化数据展示术语关系，便于理解和导航。

故障排除

空结果：确认 API Key 有效且权限正确。
连接问题：检查网络状态或尝试更换网络环境。
认证错误：重新核对用户名和密码。

高级功能

创建本地数据库

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

自定义过滤器

支持以下高级过滤选项：

property_filter：按属性筛选。
system_filter：按系统（如血液、体液）筛选。
class_filter：按分类（如 CHEM、VOL）筛选。

💻 使用示例

基础用法

{
  "query": "血红蛋白",
  "include_details": true
}

高级用法

{
  "query": "白细胞计数",
  "property_filter": "数量",
  "system_filter": "血液"
}

贡献

欢迎贡献！请通过提交 Pull Request 或 Issue 反馈问题和建议。

📄 许可证

本项目开源，采用 [LICENSE] 协议。

致谢

感谢以下机构和个人：

LOINC 提供 API 支持
LOINC 团队开发了全面的医学术语标准
Claude AI 实现了智能集成功能

创建者：Christian Delage（dr.christian.delage@gmail.com）

mcp-Loinc