Fitness Tools

Name: Fitness Tools
Author: almostjacked

远程服务

github.com/almostjacked健康医疗114 周前更新

代码仓库

关于 Fitness Tools

Fitness Tools 是一组面向健身应用开发者及 MCP 客户端的确定性计算器，可计算基础代谢、体脂、训练表现与营养指标。每项计算会结合多种已发布公式给出共识结果。

主要功能

01BMR 与 TDEE 计算
02自适应 TDEE 计算
03体脂率与 1RM 计算
04宏量营养素计算
05力量举试举与自然肌肉潜力评估

适用场景

01在应用中集成健身计算器
02估算每日能量消耗与宏量营养素
03评估体脂率及力量举重量

MCP 相关

提供基于库构建的 MCP stdio 服务，将各计算器作为工具开放给 Agent 和 LLM 客户端；也可连接托管的 MCP 端点。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://fitness-tools-mcp.ajwallacemusic.workers.dev/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http almostjacked-fitness-tools https://fitness-tools-mcp.ajwallacemusic.workers.dev/mcp

Cursor.cursor/mcp.json

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

在 Cursor 中打开

VS Code.vscode/mcp.json

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

在 VS Code 中打开

Claude Desktopclaude_desktop_config.json

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

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"almostjacked-fitness-tools":{"serverUrl":"https://fitness-tools-mcp.ajwallacemusic.workers.dev/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包

npm@almostjacked/fitness-tools-mcp0.3.4stdio

工具

参数	类型	必填	说明
age	number	是
sex	enum	是	male \| female
height	object	是
height.unit	enum	否	cm \| in \| mm
height.value	number	是
weight	object	是
weight.unit	enum	否	kg \| lb
weight.value	any	是
methods	any	否
activity	any	是
body_fat	any	否
lean_mass	any	否

详细介绍

Fitness Tools

📖 文档 · npm

**立即与 AI 一起使用：**在 claude.ai / ChatGPT 设置中添加托管的 MCP 连接器 https://fitness-tools-mcp.ajwallacemusic.workers.dev/mcp，在 Cursor 中一键安装或在 VS Code 中安装，或获取 Claude Desktop .mcpb。

可组合、确定性的健身计算器——BMR/TDEE、体脂率、1RM、宏量营养素、活动系数、力量举试举重量和自然肌肉潜力。每个计算器都会运行多个已发表的公式，并给出它们的共识结果。

此仓库提供三个独立且可单独使用的构件：

@almostjacked/fitness-tools — npm 库。经过验证、能自我描述的计算器，可在浏览器和服务器中原生运行。这就是产品。
@almostjacked/fitness-tools-api — 基于该库构建的参考 HTTP 服务。它通过 HTTP 重新提供相同的计算器（数学计算相同，结果相同），在运行或托管之前不会执行任何操作。
@almostjacked/fitness-tools-mcp — 基于该库构建的 MCP stdio 服务。它将相同的计算器作为 MCP 工具提供给 Agent/大模型客户端（数学计算相同），可通过 npx @almostjacked/fitness-tools-mcp 运行。

你需要哪一个？

你要……	使用	原因
编写 JS/TS（浏览器、Node、edge）	`@almostjacked/fitness-tools`（npm）	在进程内运行。安装、导入、调用即可。无需服务或网络。
从其他语言、`curl` 或无代码工具调用	`@almostjacked/fitness-tools-api`（HTTP）	通过 HTTP 使用相同的计算器。由你运行或托管。
构建远程前端	`@almostjacked/fitness-tools-api`	通过网络提供自我描述的目录和 OpenAPI。
将计算器接入 MCP 客户端 / Agent	`@almostjacked/fitness-tools-mcp`	通过 `npx` 运行 MCP stdio 服务；每个计算器对应一个工具。

API 增加的是网络边界，而非功能。安装后即可使用该包；服务只有在运行后才会执行操作。

文档

刚开始使用？ 入门指南
各计算器的功能： 工具
从 Agent 调用： 使用者指南
参与此仓库开发： AGENTS.md

目录结构

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

开发

corepack enable              # pnpm version is pinned in package.json
pnpm install
pnpm -r test                 # core + api + mcp test suites
pnpm -C packages/core build  # build the library
pnpm -C apps/api dev         # run the reference server on :8080

请参阅各软件包的 README — 库 · 参考服务。