Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

儿童哮喘评分(PAS)计算器

📖 简介

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

🎯 主要功能

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

🏥 医学背景

PAS 评分系统概述

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

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

年龄分组呼吸频率标准

年龄组 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
  }
}

临床应用场景

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

⚙️ 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: 只能说单词或短语(或哼哼声)

⚠️ 重要提醒

  1. 医疗免责: 此工具仅供医疗专业人员参考,不能替代临床判断
  2. 专业使用: 所有医疗决策应基于完整的临床评估和专业医学判断
  3. 紧急情况: 遇到重度评分(≥13分)时应立即采取紧急医疗措施
  4. 年龄限制: 仅适用于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 兼容: 支持一键安装的桌面扩展格式

📚 参考文献

  1. Gorelick MH, et al. Validity and reliability of the Pulmonary Index Score in childhood asthma. Academic Emergency Medicine. 2004;11(1):10-18.

  2. 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.

  3. 中华医学会儿科学分会呼吸学组. 儿童支气管哮喘诊断与防治指南(2016年版). 中华儿科杂志. 2016;54(3):167-181.

  4. Global Initiative for Asthma. Global Strategy for Asthma Management and Prevention. 2023 Update.

📄 许可证

MIT License - 详见 LICENSE 文件

🤝 贡献

欢迎提交 Issues 和 Pull Requests 来改进这个项目。

🔗 相关链接


免责声明: 此工具仅供教育和研究目的,不应用于实际临床诊疗决策。使用者需要具备相应的医学知识和临床经验。