a207-nutrition-calc-mcp

儿童慢性肾脏病（CKD）营养与食物计算 MCP 包，供 CKDNutri 项目的医生、营养师、家长三类智能体共用（M5 营养/食物计算器）。

依据：PRNT 2020（儿童 CKD 能量与蛋白 SDI）、Schofield 方程、腹膜透析葡萄糖吸收折算。

注意：本包不提供目标计算（原 calc_nutrition_target 已去重，目标计算统一由 M3 calc_prnt_targets 作为唯一权威引擎）。本包定位为纯食物层（查养分/份量换算/替换/磷蛋白比/腹透葡萄糖/药食交互）。

单位口径

• 能量：kcal；蛋白/钾/磷/钠：g 或 mg（食物成分表以 mg/100g 计）；血电解质：mmol/L
• 体重：kg；身高：cm；年龄：岁（内部按月龄插值）

七个工具

工具	说明
lookup_food_nutrients	食物营养素查询，支持份量（碗/个/掌心/克）与烹饪降钾降磷处理，返回高钾/高磷/高钠警示
substitute_food	食物替换：低钾 / 低磷 / 低钠 / 低蛋白 / 等能量，优先同类食物候选
convert_to_household_measure	克 ↔ 家庭量具双向换算，附家长可感知锚点（鸡蛋/掌心瘦肉/牛奶/瓷勺油/碗饭）
sum_diet_intake	多日饮食汇总，对比目标给出能量/蛋白达成率与钾磷钠来源排序及建议
calc_pnpr	磷蛋白比（mg P/g 蛋白）计算，辅助低磷食物优选
calc_pd_glucose_absorption	腹膜透析葡萄糖吸收量（按留腹时长 × 转运特性），折算 kcal
check_drug_nutrient_interaction	药物-营养素交互提示（磷结合剂、活性维 D、利尿剂、激素、铁剂等）

目录结构

a207-nutrition-calc-mcp/
├── pyproject.toml
├── README.md
├── src/a207_nutrition_calc_mcp/
│   ├── __init__.py
│   ├── core.py          # 7 工具门面（纯逻辑，无 MCP/pydantic 依赖）
│   ├── server.py        # FastMCP >=2 服务定义（8 个 @mcp.tool）
│   ├── models.py        # pydantic v2 入参模型（extra=forbid）
│   ├── constants.py     # 参考表与阈值
│   ├── targets.py       # 腹透葡萄糖吸收折算（目标计算已收归 M3）
│   ├── fooddb.py        # 食物数据访问与分级
│   ├── measures.py      # 家庭量具解析
│   ├── foods.py         # 查询/替换/换算/磷蛋白比
│   ├── diary.py         # 饮食汇总
│   ├── pharma.py        # 药物-营养素交互
│   └── data/food_data.csv
└── tests/test_tools.py

设计约束

• 不依赖、不 import 任何其它 a207-* 包（纯计算，无写权限）
• 结果可解释：返回 guideline 引用与规则依据
• 仅正向/边界/超时分支齐全，错误以 {"ok": false, "error": ...} 形式返回

运行与测试

# 编译（server.py/models.py 依赖 fastmcp/pydantic，仅做语法校验）
python -m py_compile src/a207_nutrition_calc_mcp/*.py

# 纯标准库自测（core 逻辑不依赖 fastmcp/pydantic，可独立运行）
python tests/test_tools.py

返回非零退出码表示存在失败用例。

启动 MCP 服务

pip install -e .
python -m a207_nutrition_calc_mcp.server
# 或
fastmcp dev src/a207_nutrition_calc_mcp/server.py
# 或（已注册 console script 后）
uvx --from . a207-nutrition-calc-mcp