npm package: @medical-mcp/pediatric-asthma-score-mcp-server
Description: 儿童哮喘评分（PAS）计算器 - 用于评估2-18岁儿童哮喘严重程度的医疗工具
Author: Andy
Latest version: 1.0.0

# 儿童哮喘评分（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 包安装

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

### 在 Claude Desktop 中配置

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

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

### 直接运行

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

## 📊 使用示例

### 基本计算示例

```typescript
// 输入参数
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](LICENSE) 文件

## 🤝 贡献

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

## 🔗 相关链接

- [项目主页](https://github.com/shanggqm/awesome-medical-mcp-server)
- [MCP 协议文档](https://modelcontextprotocol.io/)
- [Claude Desktop](https://claude.ai/desktop)

---

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