HL7 Tools — Parser, Validator, FHIR R4 Converter

Name: HL7 Tools — Parser, Validator, FHIR R4 Converter
Author: easysolutions906

本地服务

github.com/easysolutions906健康医疗132 周前更新

代码仓库

关于 HL7 Tools — Parser, Validator, FHIR R4 Converter

HL7 Tools 是提供 REST API 的 MCP 服务，可解析、验证、解释、生成、比较和转换 HL7 v2 消息，面向医疗互操作工作，并支持与 FHIR R4 双向转换。

主要功能

01将 HL7 v2 解析为结构化 JSON
02解释并验证消息
03生成并比较消息
04转换 HL7 v2 与 FHIR R4
05查询段和字段定义

适用场景

01检查并验证收到的 HL7 消息
02为医疗工作流创建测试消息
03在 HL7 v2 与 FHIR R4 间转换数据

MCP 相关

它向 MCP 客户端提供九种工具，用于 HL7 解析、解释、验证、生成、比较、转换及定义查询。

#hl7 #fhir #healthcare #parser #interoperability #mcp

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "hl7-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@easysolutions906/hl7-tools"
      ]
    }
  }
}

启动命令npx -y @easysolutions906/hl7-tools

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@easysolutions906/hl7-toolsstdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
message	string	是	原始 HL7 v2 消息（使用管道符分隔，段之间以 \r 或 \n 分隔）
version	string	否	HL7 版本覆盖值（若省略，则从 MSH-12 自动检测）

详细介绍

HL7 Tools — MCP 服务 + REST API

HL7 v2.x 解析器、查看器、验证器、测试消息生成器和 FHIR R4 转换器。

功能

解析原始 HL7 v2 管道分隔消息，并将其转换为包含命名字段的结构化 JSON
说明消息中的字段，提供易于理解的字段描述（CARISTIX 风格）
验证消息是否符合 20 多种消息类型的段和字段要求
生成逼真的测试消息，支持 ADT、ORM、ORU、SIU、MDM、DFT、VXU
比较两条 HL7 消息，查找字段级差异
转换 HL7 v2 为 FHIR R4 Bundle（10 种资源映射）
转换 FHIR R4 Bundle 回 HL7 v2
查询 2.3–2.8 版本中的任意段或字段定义

支持的段（20 个，包含完整定义）

MSH、EVN、PID、PD1、NK1、PV1、PV2、IN1、GT1、DG1、ORC、OBR、OBX、AL1、SCH、NTE、FT1、PR1、RXA、RXE

快速开始

npm install
npm run dev       # HTTP mode on port 3200
npm start         # stdio mode (for MCP clients)

MCP 工具

工具	描述
`hl7_parse`	将 HL7 v2 消息解析为结构化 JSON
`hl7_explain`	以易于理解的方式说明每个字段
`hl7_validate`	验证消息结构和必填字段
`hl7_generate`	使用虚构数据生成示例消息
`hl7_diff`	逐字段比较两条消息
`hl7_to_fhir`	将 HL7 v2 转换为 FHIR R4 Bundle
`fhir_to_hl7`	将 FHIR R4 Bundle 转换为 HL7 v2
`hl7_segments`	列出所有段及其字段数量
`hl7_field_info`	查询特定字段的定义

REST API

POST /parse       — Parse a message
POST /explain     — Explain a message
POST /validate    — Validate a message
POST /generate    — Generate a test message
POST /diff        — Diff two messages
POST /to-fhir     — Convert HL7 to FHIR
POST /to-hl7      — Convert FHIR to HL7
GET  /segments    — List segments (?version=2.5.1)
GET  /field       — Field info (?segment=PID&field=3)
GET  /health      — Health check
GET  /            — API info

支持 Markdown

登录后评论