hevy-mcp 1.13.0 → 1.13.2

package/README.md

@@ -15,11 +15,22 @@ A Model Context Protocol (MCP) server implementation that interfaces with the [H
 
 > **Note:** HTTP transport and Docker images remain deprecated. Smithery deployment now uses the official TypeScript runtime flow (no Docker required), or you can run the server locally via stdio (e.g., `npx hevy-mcp`). Existing GHCR images remain available but are no longer updated.
 
+## Quick start
+
+Pick the workflow that fits your setup:
+
+| Scenario | Command | Requirements |
+| --- | --- | --- |
+| One-off stdio run | `HEVY_API_KEY=sk_live... npx -y hevy-mcp` | Node.js ≥ 20, Hevy API key |
+| Local development | `pnpm install && pnpm run dev` | `.env` with `HEVY_API_KEY`, pnpm via Corepack |
+| Smithery playground / deploy | `pnpm run smithery:dev` / `pnpm run smithery:build` | `HEVY_API_KEY`, `SMITHERY_API_KEY` (or `pnpm dlx @smithery/cli login`) |
+
 ## Prerequisites
 
 - Node.js (v20 or higher)
 - pnpm (via Corepack)
 - A Hevy API key
+  - Optional: A Smithery account + API key/login if you plan to deploy via Smithery
 
 ## Installation
 
@@ -39,8 +50,11 @@ cd hevy-mcp
 
 # Install dependencies
 corepack use pnpm@10.22.0
+pnpm install
+
+# Create .env and add your keys (never commit real keys)
 cp .env.sample .env
-# Edit .env and add your Hevy API key
+# Edit .env and add at least HEVY_API_KEY. Add SMITHERY_API_KEY if you use Smithery CLI.
 ```
 
 ### Integration with Cursor
@@ -104,6 +118,8 @@ Smithery can bundle and host `hevy-mcp` without Docker by importing the exported
 
 4. Connect the repository to Smithery and trigger a deployment from their dashboard. Configuration is handled entirely through the exported Zod schema, so no additional `smithery.yaml` env mapping is required.
 
+> **Why are `chalk`, `cors`, and `@smithery/sdk` dependencies?** Smithery’s TypeScript runtime injects its own Express bootstrap that imports these packages. Declaring them in `package.json` ensures the Smithery CLI can bundle your server successfully.
+
 hevy-mcp now runs exclusively over stdio, which works seamlessly with MCP-aware clients like Claude Desktop and Cursor. HTTP transport has been removed to simplify deployment.
 
 ## Usage
@@ -265,6 +281,13 @@ Kubb generates TypeScript types, API clients, Zod schemas, and mock data from th
 
 - **Rollup optional dependency missing**: If you see an error similar to `Cannot find module @rollup/rollup-linux-x64-gnu`, set the environment variable `ROLLUP_SKIP_NODEJS_NATIVE_BUILD=true` before running `pnpm run build`. This forces Rollup to use the pure JavaScript fallback and avoids the npm optional dependency bug on some Linux runners.
 
+### Troubleshooting Smithery deployments
+
+- **`smithery.yaml` validation failed (unexpected fields)**: Only `runtime`, `target`, and `env` are allowed for the TypeScript runtime. Remove `entry`, `name`, or other fields.
+- **`Could not resolve "chalk"/"cors"`**: Run `pnpm install` so the runtime dependencies listed in `package.json` are present before invoking Smithery.
+- **`Failed to connect to Smithery API: Unauthorized`**: Log in via `pnpm dlx @smithery/cli login` or set `SMITHERY_API_KEY` in `.env`.
+- **Tunnel crashes with `RangeError: Invalid count value`**: This is a known issue in certain `@smithery/cli` builds. Upgrade/downgrade the CLI (e.g., `pnpm add -D @smithery/cli@latest`) or contact Smithery support.
+
 ## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/dist/cli.js

@@ -10,7 +10,7 @@ import { z as z6 } from "zod";
 
 // package.json
 var name = "hevy-mcp";
-var version = "1.12.24";
+var version = "1.13.1";
 
 // src/tools/folders.ts
 import { z } from "zod";
@@ -343,9 +343,12 @@ function registerRoutineTools(server, hevyClient) {
         sets: z2.array(
           z2.object({
             type: z2.enum(["warmup", "normal", "failure", "dropset"]).default("normal"),
+            weight: z2.coerce.number().optional(),
             weightKg: z2.coerce.number().optional(),
             reps: z2.coerce.number().int().optional(),
+            distance: z2.coerce.number().int().optional(),
             distanceMeters: z2.coerce.number().int().optional(),
+            duration: z2.coerce.number().int().optional(),
             durationSeconds: z2.coerce.number().int().optional(),
             customMetric: z2.coerce.number().optional()
           })
@@ -378,10 +381,10 @@ function registerRoutineTools(server, hevyClient) {
               sets: exercise.sets.map(
                 (set) => ({
                   type: set.type,
-                  weight_kg: set.weightKg ?? null,
+                  weight_kg: set.weight ?? set.weightKg ?? null,
                   reps: set.reps ?? null,
-                  distance_meters: set.distanceMeters ?? null,
-                  duration_seconds: set.durationSeconds ?? null,
+                  distance_meters: set.distance ?? set.distanceMeters ?? null,
+                  duration_seconds: set.duration ?? set.durationSeconds ?? null,
                   custom_metric: set.customMetric ?? null
                 })
               )
@@ -414,9 +417,12 @@ function registerRoutineTools(server, hevyClient) {
         sets: z2.array(
           z2.object({
             type: z2.enum(["warmup", "normal", "failure", "dropset"]).default("normal"),
+            weight: z2.coerce.number().optional(),
             weightKg: z2.coerce.number().optional(),
             reps: z2.coerce.number().int().optional(),
+            distance: z2.coerce.number().int().optional(),
             distanceMeters: z2.coerce.number().int().optional(),
+            duration: z2.coerce.number().int().optional(),
             durationSeconds: z2.coerce.number().int().optional(),
             customMetric: z2.coerce.number().optional()
           })
@@ -448,10 +454,10 @@ function registerRoutineTools(server, hevyClient) {
               sets: exercise.sets.map(
                 (set) => ({
                   type: set.type,
-                  weight_kg: set.weightKg ?? null,
+                  weight_kg: set.weight ?? set.weightKg ?? null,
                   reps: set.reps ?? null,
-                  distance_meters: set.distanceMeters ?? null,
-                  duration_seconds: set.durationSeconds ?? null,
+                  distance_meters: set.distance ?? set.distanceMeters ?? null,
+                  duration_seconds: set.duration ?? set.durationSeconds ?? null,
                   custom_metric: set.customMetric ?? null
                 })
               )
@@ -762,9 +768,12 @@ function registerWorkoutTools(server, hevyClient) {
         sets: z5.array(
           z5.object({
             type: z5.enum(["warmup", "normal", "failure", "dropset"]).default("normal"),
+            weight: z5.coerce.number().optional().nullable(),
             weightKg: z5.coerce.number().optional().nullable(),
             reps: z5.coerce.number().int().optional().nullable(),
+            distance: z5.coerce.number().int().optional().nullable(),
             distanceMeters: z5.coerce.number().int().optional().nullable(),
+            duration: z5.coerce.number().int().optional().nullable(),
             durationSeconds: z5.coerce.number().int().optional().nullable(),
             rpe: z5.coerce.number().optional().nullable(),
             customMetric: z5.coerce.number().optional().nullable()
@@ -794,16 +803,16 @@ function registerWorkoutTools(server, hevyClient) {
           exercises: exercises.map(
             (exercise) => ({
               exercise_template_id: exercise.exerciseTemplateId,
-              superset_id: exercise.supersetId || null,
-              notes: exercise.notes || null,
+              superset_id: exercise.supersetId ?? null,
+              notes: exercise.notes ?? null,
               sets: exercise.sets.map((set) => ({
                 type: set.type,
-                weight_kg: set.weightKg || null,
-                reps: set.reps || null,
-                distance_meters: set.distanceMeters || null,
-                duration_seconds: set.durationSeconds || null,
-                rpe: set.rpe || null,
-                custom_metric: set.customMetric || null
+                weight_kg: set.weight ?? set.weightKg ?? null,
+                reps: set.reps ?? null,
+                distance_meters: set.distance ?? set.distanceMeters ?? null,
+                duration_seconds: set.duration ?? set.durationSeconds ?? null,
+                rpe: set.rpe ?? null,
+                custom_metric: set.customMetric ?? null
               }))
             })
           )
@@ -837,9 +846,12 @@ function registerWorkoutTools(server, hevyClient) {
         sets: z5.array(
           z5.object({
             type: z5.enum(["warmup", "normal", "failure", "dropset"]).default("normal"),
+            weight: z5.coerce.number().optional().nullable(),
             weightKg: z5.coerce.number().optional().nullable(),
             reps: z5.coerce.number().int().optional().nullable(),
+            distance: z5.coerce.number().int().optional().nullable(),
             distanceMeters: z5.coerce.number().int().optional().nullable(),
+            duration: z5.coerce.number().int().optional().nullable(),
             durationSeconds: z5.coerce.number().int().optional().nullable(),
             rpe: z5.coerce.number().optional().nullable(),
             customMetric: z5.coerce.number().optional().nullable()
@@ -877,16 +889,16 @@ function registerWorkoutTools(server, hevyClient) {
           exercises: exercises.map(
             (exercise) => ({
               exercise_template_id: exercise.exerciseTemplateId,
-              superset_id: exercise.supersetId || null,
-              notes: exercise.notes || null,
+              superset_id: exercise.supersetId ?? null,
+              notes: exercise.notes ?? null,
               sets: exercise.sets.map((set) => ({
                 type: set.type,
-                weight_kg: set.weightKg || null,
-                reps: set.reps || null,
-                distance_meters: set.distanceMeters || null,
-                duration_seconds: set.durationSeconds || null,
-                rpe: set.rpe || null,
-                custom_metric: set.customMetric || null
+                weight_kg: set.weight ?? set.weightKg ?? null,
+                reps: set.reps ?? null,
+                distance_meters: set.distance ?? set.distanceMeters ?? null,
+                duration_seconds: set.duration ?? set.durationSeconds ?? null,
+                rpe: set.rpe ?? null,
+                custom_metric: set.customMetric ?? null
               }))
             })
           )