npm @almostjacked/fitness-tools-mcpstreamable-httpMITupdated 1mo ago
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.
Was kannst du mit Fitness Tools machen?
Fitness Tools
📖 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 withnpx @almostjacked/fitness-tools-mcp.
Which one do you want?
| You're… | Use | Why |
|---|---|---|
| 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-api |
Self-describing catalog + OpenAPI over the wire. |
| Wiring the calculators into an MCP client / agent | @almostjacked/fitness-tools-mcp |
npx 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
- New to it? Getting started
- What each calculator does: Tools
- Calling from an agent: Consumer guide
- Working on this repo: AGENTS.md
Layout
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
Develop
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
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.
Installation
Fitness Tools zu deinem Client hinzufügen. Wähl den, den du nutzt.
{
"servers": {
"fitness-tools-mcp": {
"type": "http",
"url": "https://fitness-tools-mcp.ajwallacemusic.workers.dev/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
claude mcp add fitness-tools-mcp -- npx -y @almostjacked/fitness-tools-mcpcodex mcp add fitness-tools-mcp -- npx -y @almostjacked/fitness-tools-mcpamp mcp add fitness-tools-mcp -- npx -y @almostjacked/fitness-tools-mcp{
"mcpServers": {
"fitness-tools-mcp": {
"command": "npx",
"args": [
"-y",
"@almostjacked/fitness-tools-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"fitness-tools-mcp": {
"command": "npx",
"args": [
"-y",
"@almostjacked/fitness-tools-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"mcpServers": {
"fitness-tools-mcp": {
"command": "npx",
"args": [
"-y",
"@almostjacked/fitness-tools-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"fitness-tools-mcp": {
"command": "npx",
"args": [
"-y",
"@almostjacked/fitness-tools-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"fitness-tools-mcp": {
"command": "npx",
"args": [
"-y",
"@almostjacked/fitness-tools-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"fitness-tools-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@almostjacked/fitness-tools-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"fitness-tools-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"@almostjacked/fitness-tools-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y @almostjacked/fitness-tools-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Score
39 / 100
Unvollständig
- Dokumentation21/25
- Pflege22/25
- Vertrauen16/20
- Funktionsumfang0/15
- Installation15/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 38 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 18 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Versionsverlauf
| Versionen | Veröffentlicht |
|---|---|
| 0.3.4Aktuell | 24. Juli 2026 |
| 0.3.2 | 23. Juli 2026 |
| 0.3.1 | 23. Juli 2026 |