@medical-mcp/pediatric-asthma-score-mcp-server

v1.0.0

Published

8 months ago

儿童哮喘评分（PAS）计算器 - 用于评估2-18岁儿童哮喘严重程度的医疗工具

0High
0Medium
0Low

guomeiqing

mcp medical pediatric asthma score PAS healthcare children

儿童哮喘评分（PAS）计算器

📖 简介

儿童哮喘评分（Pediatric Asthma Score, PAS）是一个标准化的评估工具，用于评估2-18岁儿童哮喘急性发作的严重程度。该 MCP 服务器实现了完整的 PAS 计算功能，通过评估呼吸频率、氧饱和度、听诊结果、吸气性凹陷和呼吸困难程度等5个关键指标，为临床医生提供客观的哮喘严重程度评估。

🎯 主要功能

准确计算: 基于标准 PAS 评分系统进行精确计算
年龄适配: 根据不同年龄组调整呼吸频率评分标准
智能验证: 全面的输入参数验证和异常值检测
风险提醒: 自动生成临床警告和治疗建议
双语支持: 提供中英文对照的医疗术语
标准输出: 符合医疗规范的结构化报告格式

🏥 医学背景

PAS 评分系统概述

PAS 评分系统包含以下5个评估维度，每个维度评分1-3分，总分5-15分：

呼吸频率: 根据年龄分组的呼吸频率标准
氧饱和度需求: 评估氧气需求程度
听诊结果: 评估气道阻塞程度
吸气性凹陷: 评估呼吸功的增加
呼吸困难: 评估患儿呼吸窘迫程度

年龄分组呼吸频率标准

| 年龄组 | 1分 (正常) | 2分 (轻度增快) | 3分 (明显增快) | | ------ | ---------- | -------------- | -------------- | | 2-3岁 | ≤34次/分 | 35-39次/分 | ≥40次/分 | | 4-5岁 | ≤30次/分 | 31-35次/分 | ≥36次/分 | | 6-12岁 | ≤26次/分 | 27-30次/分 | ≥31次/分 | | >12岁 | ≤23次/分 | 24-27次/分 | ≥28次/分 |

严重程度分级

轻度 (5-8分): 轻度哮喘发作，通常可在门诊治疗
中度 (9-12分): 中度哮喘发作，需要更积极的治疗，可能需要住院观察
重度 (13-15分): 重度哮喘发作，需要立即住院治疗，可能需要ICU监护

🔧 安装和使用

作为 npm 包安装

npm install @medical-mcp/pediatric-asthma-score-mcp-server

在 Claude Desktop 中配置

在 Claude Desktop 的配置文件中添加：

{
  "mcpServers": {
    "pediatric-asthma-score": {
      "command": "npx",
      "args": ["@medical-mcp/pediatric-asthma-score-mcp-server"]
    }
  }
}

直接运行

npx @medical-mcp/pediatric-asthma-score-mcp-server

📊 使用示例

基本计算示例

// 输入参数
const input = {
  age: 8,                      // 8岁
  respiratory_rate: 35,        // 呼吸频率 35次/分钟
  oxygen_demand: 2,            // 90-95%在室内空气中
  auscultation: 2,             // 呼气喘鸣
  inspiratory_retractions: 2,   // 肋间和胸骨下
  dyspnea: 2                   // 只能说部分句子
};

// 计算结果
{
  "total_score": 11,
  "severity": "中度",
  "severity_classification": {
    "level": "moderate",
    "level_cn": "中度",
    "score_range": "9-12分",
    "clinical_significance": "中度哮喘发作，需要更积极的治疗，可能需要住院观察..."
  },
  "score_breakdown": {
    "respiratory_rate_score": 3,
    "oxygen_demand_score": 2,
    "auscultation_score": 2,
    "inspiratory_retractions_score": 2,
    "dyspnea_score": 2
  }
}

临床应用场景

急诊科评估: 快速评估儿童哮喘发作严重程度
住院决策: 辅助判断是否需要住院治疗
治疗监测: 跟踪治疗效果和病情变化
转诊依据: 为转诊决策提供客观评估

⚙️ API 接口

`calculate_pediatric_asthma_score`

计算儿童哮喘评分的主要工具。

输入参数

| 参数名 | 类型 | 范围 | 描述 | | ------------------------- | ------ | ----- | ------------------- | | age | number | 2-18 | 患儿年龄（岁） | | respiratory_rate | number | 10-80 | 呼吸频率（次/分钟） | | oxygen_demand | number | 1-3 | 氧饱和度需求等级 | | auscultation | number | 1-3 | 听诊结果等级 | | inspiratory_retractions | number | 1-3 | 吸气性凹陷等级 | | dyspnea | number | 1-3 | 呼吸困难等级 |

选项说明

氧饱和度需求 (oxygen_demand)

1: >95%在室内空气中
2: 90-95%在室内空气中
3: <90%在室内空气中或任何补充氧气

听诊结果 (auscultation)

1: 正常呼吸音至呼气末喘鸣
2: 呼气喘鸣
3: 吸气和呼气喘鸣至呼吸音减弱

吸气性凹陷 (inspiratory_retractions)

1: 无或仅肋间
2: 肋间和胸骨下
3: 肋间、胸骨下和锁骨上

呼吸困难 (dyspnea)

1: 能说完整句子（或咕噜声和咿呀学语）
2: 只能说部分句子（或短哭声）
3: 只能说单词或短语（或哼哼声）

⚠️ 重要提醒

医疗免责: 此工具仅供医疗专业人员参考，不能替代临床判断
专业使用: 所有医疗决策应基于完整的临床评估和专业医学判断
紧急情况: 遇到重度评分（≥13分）时应立即采取紧急医疗措施
年龄限制: 仅适用于2-18岁儿童，不适用于成人或婴幼儿

🏗️ 技术架构

技术栈

TypeScript: 严格类型检查和现代 ES 特性
MCP SDK: Model Context Protocol 1.17.3
Node.js: ≥18.0.0，ES Modules 支持
DXT: Desktop Extensions 格式支持

项目结构

src/
├── index.ts          # MCP 服务器主文件
├── types.ts          # TypeScript 类型定义
scripts/
├── pack-dxt.js       # DXT 打包脚本
manifest.json         # DXT 扩展清单
package.json          # npm 包配置
tsconfig.json         # TypeScript 配置

核心特性

严格类型检查: 完整的 TypeScript 类型定义
输入验证: 全面的参数验证和错误处理
医疗安全: 内置临床警告和安全检查
国际化: 中英文双语医疗术语支持
DXT 兼容: 支持一键安装的桌面扩展格式

📚 参考文献

Gorelick MH, et al. Validity and reliability of the Pulmonary Index Score in childhood asthma. Academic Emergency Medicine. 2004;11(1):10-18.
Ducharme FM, et al. The Pediatric Respiratory Assessment Measure: a valid clinical score for assessing acute asthma severity from toddlers to teenagers. Journal of Pediatrics. 2008;152(4):476-480.
中华医学会儿科学分会呼吸学组. 儿童支气管哮喘诊断与防治指南（2016年版）. 中华儿科杂志. 2016;54(3):167-181.
Global Initiative for Asthma. Global Strategy for Asthma Management and Prevention. 2023 Update.