Fitness Tools

io.github.almostjacked由 GitHub 账号 almostjacked 发布v0.3.4更新于 Oct 25, 2026

Deterministic fitness calculators — TDEE, adaptive TDEE, body fat, 1RM, macros — with consensus.

已验证Streamable HTTP可网页运行位置与生活数据与分析

概览

AI 生成的概览

一个健身计算器服务器,让助手用已发表的公式计算 TDEE、体脂率、单次最大重量、宏量营养素、举重试举和肌肉潜力估算。

可以做什么
估算能量需求:用多种公式计算 BMR/TDEE,根据记录的体重和热量历史计算自适应 TDEE,并用查表或 NEAT+EAT 模型估算活动系数。估算身体成分:用海军围度、皮褶和 BMI 方法计算体脂率,计算 FFMI 并标记是否超过自然上限,以及计算 RSMI 并对照肌少症阈值。估算力量:由次最大组估算单次最大重量并给出百分比负荷表,以及生成力量举开把、第二把、第三把试举、热身递增和杠铃片配置。规划营养:按热量目标计算蛋白质、脂肪和碳水克数。估算目标体脂率下的无药物最大体重。
适用场景
适合需要助手做可重复的健身计算而不是临时编数字的场景:训练计划、热量与宏量营养素目标、力量进阶,或身体成分与肌肉潜力估算。每个计算器会运行多个已发表公式并给出共识结果,适合希望看到方法和结果区间的用户。
运行要求
可作为托管远程端点使用,也可通过 npm 包的 npx 作为本地 stdio 进程运行。未声明认证、环境变量或请求头。本地方式需要 Node.js,并需要网络访问以获取该包。
安装前请注意
这些计算器基于人群公式给出估算,不是医疗建议或实际测量。肌肉潜力工具在当前版本仅支持男性。自适应 TDEE 依赖用户提供的体重和热量历史,结果取决于记录质量。不涉及凭据或写入操作。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Fitness Tools,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.almostjacked%2Ffitness-tools/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "fitness-tools": {
      "type": "http",
      "url": "https://fitness-tools-mcp.ajwallacemusic.workers.dev/mcp"
    }
  }
}

README

Fitness Tools

[CI] [License: MIT] [npm] [MCP Registry]

📖 Documentation · npm

Use it with your AI right now: add the hosted MCP connector https://fitness-tools-mcp.ajwallacemusic.workers.dev/mcp in claude.ai / ChatGPT settings, install one-click in Cursor or VS Code, or grab the Claude Desktop .mcpb.

Composable, deterministic fitness calculators — BMR/TDEE, body fat, 1RM, macros, activity multiplier, powerlifting attempts, and natural muscular potential. Each calculator runs several published formulas and reports a consensus across them.

This repo ships three separate, independently-usable artifacts:

  • @almostjacked/fitness-tools — the npm library. Validated, self-describing calculators that run natively in the browser and on the server. This is the product.
  • @almostjacked/fitness-tools-api — a reference HTTP server built on the library. It re-exposes the same calculators over HTTP (identical math, identical results) and is inert until you run or host it.
  • @almostjacked/fitness-tools-mcp — an MCP stdio server built on the library. It exposes the same calculators as MCP tools for agents/LLM clients (identical math), runnable with npx @almostjacked/fitness-tools-mcp.

Which one do you want?

You're…UseWhy
Writing JS/TS (browser, Node, edge)@almostjacked/fitness-tools (npm)Runs in-process. Install, import, call. No server, no network.
Calling from another language / curl / a no-code tool@almostjacked/fitness-tools-api (HTTP)Same calculators over HTTP. You run/host it.
Building a remote frontend@almostjacked/fitness-tools-apiSelf-describing catalog + OpenAPI over the wire.
Wiring the calculators into an MCP client / agent@almostjacked/fitness-tools-mcpnpx an MCP stdio server; one tool per calculator.

The API adds a network boundary, not capability. The package works the moment you install it; the server does nothing until it's running.

Documentation

Layout

packages/core   @almostjacked/fitness-tools — the library (the product)apps/api        @almostjacked/fitness-tools-api  — a reference HTTP server over the libraryapps/mcp        @almostjacked/fitness-tools-mcp  — an MCP stdio server over the library

Develop

bash
corepack enable              # pnpm version is pinned in package.jsonpnpm installpnpm -r test                 # core + api + mcp test suitespnpm -C packages/core build  # build the librarypnpm -C apps/api dev         # run the reference server on :8080

See each package's README — library · reference server.

License

MIT — free, open-source, and usable in commercial products. See LICENSE. Built on published formulas (Mifflin-St Jeor, US Navy, Jackson-Pollock, Epley, Casey Butt, etc.); contributions welcome.

来源:README.md,提交 ee0b492

工具

10

tdee

Total Daily Energy Expenditure

Estimate BMR and TDEE via Mifflin-St Jeor, Harris-Benedict, Katch-McArdle, and Cunningham. Provide body_fat or lean_mass to unlock the LBM-based methods.

输入参数age必填sex必填height必填weight必填methodsactivity必填body_fatlean_mass

adaptive-tdee

Adaptive TDEE

Measure actual TDEE from a logged history of daily weight and/or calorie intake. Default method (kalman) is a joint Kalman filter over true weight and TDEE — handles missing days, gates outliers, and reports uncertainty (CI95) alongside denoised true weight; regression/endpoints are simple window-based estimates kept for comparison. Use instead of formula TDEE once real logged data exists. Each entry needs at least one of weight/kcal (not necessarily both). Entry dates must span 10 years or less (earliest to latest). Note: all methods need at least one weigh-in (kalman) or two (regression/endpoints) — a history with zero weight entries throws under the kalman default; pass methods:'all' to get a graceful empty/skipped result instead.

输入参数entries必填methodswindow_daysprior_tdee_kcal

body-fat

Body Fat Percentage

Estimate body-fat % via US Navy circumference, Jackson-Pollock 3-site skinfold, and Deurenberg (BMI-based) methods.

输入参数agehipsex必填neckwaistheightweightmethodsskinfold_sum

one-rep-max

One-Rep Max

Estimate 1RM from a submaximal set via Epley, Brzycki, Lombardi, Wathan, O'Conner, and Mayhew; returns a %1RM load chart.

输入参数reps必填weight必填methods

macros

Macronutrient Split

Compute protein/fat/carb grams for a calorie target using the g-per-kg-bodyweight method, with goal-based protein defaults.

输入参数goalweight必填methodscalories必填fat_g_per_kgprotein_g_per_kg

activity-multiplier

Activity Multiplier

Estimate the TDEE activity multiplier via the classic lookup table or a NEAT+EAT model (occupation/steps for non-exercise, training volume for exercise).

输入参数bmrweightmethodsintensityoccupationsteps_per_dayactivity_levelsession_minutessessions_per_week

powerlifting-attempts

Powerlifting Meet Attempts

Deterministic opener/second/third attempts from an estimated 1RM, plus a warmup ramp and per-side plate loading. Tunable by aggressiveness and available plates.

输入参数bar_weightone_rep_max必填aggressivenessavailable_plates

muscle-potential

Maximum Muscular Potential

Estimate drug-free maximum bodyweight at a target body-fat % via Casey Butt (wrist+ankle), the FFMI~25 natural cap, and Berkhan's max-contest-weight model. Men only in v1.

输入参数sex必填anklewristheight必填methodstarget_body_fat_pct

ffmi

Fat-Free Mass Index

Compute the Fat-Free Mass Index (FFMI) and its height-adjusted form from weight and body fat (or lean mass), and flag whether it exceeds the ~25 natural ceiling.

输入参数height必填weight必填methodsbody_fatlean_mass

rsmi

Relative Skeletal Muscle Index

Estimate the appendicular skeletal muscle index (RSMI) from a DXA value (direct) and/or an anthropometric estimate (Wen 2011), and flag low muscle mass against EWGSOP2, AWGS, and Baumgartner sarcopenia cutoffs.

输入参数age必填sex必填asm_kgheight必填weight必填methods

版本历史

1
  1. v0.3.4最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分