bodymeasure

bodymeasure

米国で、30 歳男性の身長が50パーセンタイルにあたる場合、その身長はどのくらいでしょうか？ また、34 歳女性の膝窩高を43.1 cmと測定した場合、何パーセンタイルにあたるでしょうか？ bodymeasure は人体計測の基準データを提供する Humanform API に問い合わせ、次の両方向の答えを JSON で返します。

• 順方向： パーセンタイルを指定すると、指定した性別、年齢、国の人で、そのパーセンタイルにあたる測定値を取得します。
• 逆方向： 測定値を指定すると、同じ条件の人で、その値が何パーセンタイルにあたるかを取得します。

さらに、API が対応する測定項目名と身体部位、および国コードと国名を取得する2つの一覧呼び出しも利用できます。

設定

Humanform API キーはご自身で用意してください。

export HUMANFORM_API_KEY="your key"

API キーがない場合、bodymeasure は推測で値を返しません。すべての呼び出しは HUMANFORM_API_KEY is not set で失敗し、リクエストは送信されず、測定値も生成されません。HUMANFORM_API_URL を設定すると、API のベース URL（デフォルトは https://api.humanform.app）を上書きできます。

CLI

各サブコマンドの引数は1つの JSON 文字列で指定します。2つの一覧コマンドには "{}" を指定します。

HUMANFORM_API_KEY=... npx @reneturcios/bodymeasure predict_measurement '{"measurement":"Stature","sex":"Male","age":30,"percentile":50,"country":"US","unit":"cm"}'
HUMANFORM_API_KEY=... npx @reneturcios/bodymeasure percentile_lookup '{"measurement":"PoplitealHeight","sex":"Female","age":34,"country":"US","unit":"cm","value":43.1}'
HUMANFORM_API_KEY=... npx @reneturcios/bodymeasure list_measurements '{}'
HUMANFORM_API_KEY=... npx @reneturcios/bodymeasure list_countries '{}'
npx @reneturcios/bodymeasure --version

出力は Humanform のペイロードを JSON 形式で返します。終了コード：成功時は 0、実行時エラー（キーの欠落、入力値の検証失敗、上流エラーを含む）時は 1、使用方法のエラー時は 2 です。

リクエストを送信する前に引数を検証します。文字列引数は空でないこと、age は0より大きい有限数であること、percentile は0より大きく100より小さいこと、ルックアップの value は有限であることが必要です。API 自体が error フィールドと message フィールドを含むエラーボディを返した場合は、その組み合わせを <error>: <message> として報告します。

MCP サーバー

npx -y @reneturcios/bodymeasure mcp

MCP クライアント設定：

{
  "mcpServers": {
    "bodymeasure": {
      "command": "npx",
      "args": ["-y", "@reneturcios/bodymeasure", "mcp"],
      "env": { "HUMANFORM_API_KEY": "your key" }
    }
  }
}

ツール

• predict_measurement — 順方向検索：パーセンタイル → 測定値。measurement、sex、age、percentile、country、unit が必要です。
• percentile_lookup — 逆方向検索：測定値 → パーセンタイル。measurement、sex、age、country、unit、value が必要です。
• list_measurements — 対応する測定項目名と身体部位をすべて一覧表示します。引数は不要です。
• list_countries — 対応する国コードと国名を一覧表示します。引数は不要です。

Docker

docker run -i -e HUMANFORM_API_KEY="your key" ghcr.io/cloudcorprecords/bodymeasure
docker run --rm -e HUMANFORM_API_KEY="your key" ghcr.io/cloudcorprecords/bodymeasure list_countries '{}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios