MCP 服务器

groowooth

MCP server that enables AI agents to assess child growth, plot growth curves, and interpret z-scores using WHO and China NHC standards.

README

groowooth

开源儿童成长曲线工具——支持 WHO + 中国卫健委标准，自带 AI agent 接入。 Open-source child growth curve toolkit — WHO + China NHC standards, with native AI agent (MCP) integration.

🚀 在线试用 / Try it now：https://groowooth.pages.dev

是什么

家长用浏览器记录孩子身高/体重/头围，按 WHO 2006/2007 或 中国卫健委 WS/T 423-2022 标准看百分位曲线。数据本地存（IndexedDB），零账号、零云、零广告。

同时提供 MCP server，让 Claude Desktop / Cursor / Cline 等 AI 客户端可以直接调用「评估生长」「画曲线」「解读 z-score」三个工具。

截图

<table> <tr> <td align="center"><img src="docs/screenshots/dashboard-desktop.png" alt="桌面端 Dashboard" width="640" /></td> <td align="center"><img src="docs/screenshots/dashboard-mobile.png" alt="移动端 Dashboard" width="240" /></td> </tr> <tr> <td align="center"><sub>桌面：4 张曲线 + 最近一次记录的统计解读 + 标准切换</sub></td> <td align="center"><sub>移动：单列布局，PWA 可安装</sub></td> </tr> </table>

三层架构

@groowooth/core   纯 TS 计算库 + 标准数据，零 runtime deps（除 zod）
                  WHO 2006/2007 用 LMS Box-Cox；NHC 2022 用 SD 表分段线性内插
       ↑                          ↑
       │                          │
@groowooth/web              @groowooth/mcp
React + Vite                Node + @modelcontextprotocol/sdk
IndexedDB 本地存             stdio transport，3 个 tool
家长用                       AI agent 用

快速开始

先决条件

Node.js 18+
pnpm 10+

装依赖 + 跑

pnpm install

# 网页（开发模式，http://localhost:5173）
pnpm dev:web

# 网页（生产构建）
pnpm build:web

# 跑全部测试
pnpm test

# 单独构建核心库
pnpm --filter @groowooth/core build

# 构建 MCP server（产出 packages/mcp/dist/server.js）
pnpm --filter @groowooth/mcp build

接入 Claude Desktop

构建后在 Claude Desktop 配置文件加：

{
  "mcpServers": {
    "groowooth": {
      "command": "node",
      "args": ["/path/to/groowooth/packages/mcp/dist/server.js"]
    }
  }
}

然后在 Claude 里直接说「我家娃 24 个月，身高 86 cm，体重 12 kg，按卫健委标准评估一下」即可。

核心 API

所有标准数据都是按需懒加载的。自 v0.1.0 起，核心 API 全部为 async；如果页面首屏一定会用到某个标准，可在 mount 时先 await loadStandard('nhc-2022') 预热。

import { assess, interpret, loadStandard, lookup, renderChart } from '@groowooth/core'

await loadStandard('nhc-2022')

// 评估
const result = await assess({
  ageMonths: 24,
  sex: 'female',
  heightCm: 86,
  weightKg: 12,
  standard: 'nhc-2022',
})
// → { assessments: [...], standard, standardVersion, disclaimer }

// 查曲线数据
const curves = await lookup({
  standard: 'who-2006',
  indicator: 'height-for-age',
  sex: 'male',
  xRange: [0, 60],
  percentiles: [3, 15, 50, 85, 97],
})

// 渲染 SVG
const svg = await renderChart({
  standard: 'nhc-2022',
  indicator: 'height-for-age',
  sex: 'female',
  measurements: [{ x: 24, value: 86 }],
})

// 中文统计描述（无临床建议）
const text = await interpret({
  zScore: 0.31,
  indicator: 'height-for-age',
  sex: 'female',
  ageMonths: 24,
})