hevy-mcp 1.28.0 → 2.0.0

package/README.md

@@ -15,6 +15,7 @@ A Model Context Protocol (MCP) server implementation that interfaces with the [H
 - [Quick Start](#quick-start)
 - [Prerequisites](#prerequisites)
 - [Installation](#installation)
+  - [Run with Docker](#run-with-docker)
   - [Claude Desktop Configuration](#claude-desktop-configuration)
   - [Cursor Configuration](#cursor-configuration)
   - [Other MCP Clients (via add-mcp)](#other-mcp-clients-via-add-mcp)
@@ -39,10 +40,11 @@ A Model Context Protocol (MCP) server implementation that interfaces with the [H
 
 Pick the workflow that fits your setup:
 
-| Scenario              | Command                                                                                     | Requirements               |
-| :-------------------- | :------------------------------------------------------------------------------------------ | :------------------------- |
-| **One-off stdio run** | `HEVY_API_KEY=sk_live... npx -y hevy-mcp` or `HEVY_API_KEY=sk_live... bunx hevy-mcp@latest` | Node.js ≥ 20, Hevy API key |
-| **Local development** | `npm install && npm run build && npm start`                                                 | `.env` with `HEVY_API_KEY` |
+| Scenario              | Command                                                                                 | Requirements               |
+| :-------------------- | :-------------------------------------------------------------------------------------- | :------------------------- |
+| **One-off stdio run** | `HEVY_API_KEY=your_key npx -y hevy-mcp` or `HEVY_API_KEY=your_key bunx hevy-mcp@latest` | Node.js ≥ 20, Hevy API key |
+| **Docker stdio run**  | `docker run -i --rm -e HEVY_API_KEY ghcr.io/chrisdoc/hevy-mcp:latest`                   | Docker, Hevy API key       |
+| **Local development** | `npm install && npm run build && npm start`                                             | `.env` with `HEVY_API_KEY` |
 
 ---
 
@@ -51,6 +53,7 @@ Pick the workflow that fits your setup:
 - **Node.js**: v20 or higher (strongly recommended to use the exact version pinned in `.nvmrc`).
 - **npm**: v10 or higher.
 - **Bun** (optional): If you want to launch with `bunx`.
+- **Docker** (optional): If you want an isolated container-based stdio setup.
 - **Hevy API key**: Required for all operations (available with Hevy PRO).
 
 ---
@@ -85,6 +88,26 @@ cp .env.sample .env
 # Edit .env and add your HEVY_API_KEY
 ```
 
+### Run with Docker
+
+Official multi-platform images are published to GitHub Container Registry for
+`linux/amd64` and `linux/arm64`:
+
+```bash
+export HEVY_API_KEY=your_hevy_api_key_here
+docker run -i --rm -e HEVY_API_KEY ghcr.io/chrisdoc/hevy-mcp:latest
+```
+
+The server uses stdio, so `-i` keeps standard input open for the MCP client.
+`--rm` removes the stopped container automatically. The `-e HEVY_API_KEY`
+form forwards the variable from the host environment without putting the key
+in the command arguments.
+
+Use `latest` to follow the newest stable release. For reproducible deployments,
+pin the exact version shown on the release, using a tag such as
+`ghcr.io/chrisdoc/hevy-mcp:X.Y.Z`. Major (`:X`) and major.minor (`:X.Y`) tags
+are also published for controlled automatic updates.
+
 ---
 
 ## 🔗 Integration
@@ -119,6 +142,41 @@ If you prefer Bun, swap the launcher fields:
 }
 ```
 
+To run Claude Desktop through Docker instead, first create an environment file
+outside the repository containing your real key:
+
+```dotenv
+HEVY_API_KEY=replace_with_your_real_key
+```
+
+Restrict access to that file where supported (for example,
+`chmod 600 /absolute/path/to/hevy-mcp.env`), then use its absolute path in the
+Claude Desktop configuration:
+
+```json
+{
+	"mcpServers": {
+		"hevy-mcp": {
+			"command": "docker",
+			"args": [
+				"run",
+				"-i",
+				"--rm",
+				"--env-file",
+				"/absolute/path/to/hevy-mcp.env",
+				"ghcr.io/chrisdoc/hevy-mcp:latest"
+			]
+		}
+	}
+}
+```
+
+This configuration runs the same stdio server inside the container; it does
+not expose an HTTP port or start a detached service. Docker reads the key from
+the environment file, so the Claude configuration does not replace an
+inherited key with a placeholder. Replace `latest` with an exact version tag if
+you want Claude Desktop to stay on a pinned release.
+
 ### Cursor Configuration
 
 Add this server under `"mcpServers"` in `~/.cursor/mcp.json`:
@@ -179,11 +237,18 @@ Supply your Hevy API key via the `HEVY_API_KEY` environment variable (in
 Set `HEVY_MCP_API_TIMEOUT` to override the default 30-second Hevy API request
 timeout. Its value is in milliseconds.
 
+Set `HEVY_MCP_DEBUG=1` to emit verbose, privacy-bounded diagnostics to stderr.
+Debug records include tool invocations and sanitized Hevy API response timing
+and status details. Other values leave diagnostics disabled, and stdout remains
+reserved for the MCP JSON-RPC stream.
+
 ```env
 # Example .env
 HEVY_API_KEY=your_hevy_api_key_here
 # Optional: customize Hevy API request timeout (milliseconds)
 HEVY_MCP_API_TIMEOUT=30000
+# Optional: enable verbose stderr diagnostics (only the value 1 enables it)
+HEVY_MCP_DEBUG=1
 ```
 
 ### 🧠 Exercise Template Cache Behavior
@@ -215,10 +280,11 @@ paging behavior explicit and avoid cross-page invalidation complexity.
 <details>
 <summary><strong>⚠️ Migration Note (v1.18.0)</strong></summary>
 
-As of **v1.18.0**, `hevy-mcp` removed both HTTP/SSE transport and Docker
-support.
+As of **v1.18.0**, `hevy-mcp` removed HTTP/SSE transport and its previous
+Docker packaging. Docker support is now available again for the stdio server.
 
-The supported path is stdio via `npx hevy-mcp`.
+Both `npx hevy-mcp` and the official container image use stdio; HTTP ports and
+detached-container deployment are not supported.
 
 </details>
 

package/dist/cli.mjs

@@ -4,12 +4,12 @@
 (function() {
 	try {
 		var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {};
-		e.SENTRY_RELEASE = { id: "hevy-mcp@1.28.0" };
+		e.SENTRY_RELEASE = { id: "hevy-mcp@2.0.0" };
 		var n = new e.Error().stack;
 		n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "03cf150f-6466-4ca3-9cf1-e423cc0e3cd2", e._sentryDebugIdIdentifier = "sentry-dbid-03cf150f-6466-4ca3-9cf1-e423cc0e3cd2");
 	} catch (e) {}
 })();
-import { r as runServer } from "./src-J8OsyJcw.mjs";
+import { r as runServer } from "./src-c3mB-R0m.mjs";
 //#region src/cli.ts
 runServer().catch((error) => {
 	console.error("Fatal error in main():", error);

package/dist/index.d.mts

@@ -14,7 +14,7 @@ declare function createServer({
   config
 }: {
   config: ServerConfig;
-}): McpServer;
+}): Promise<McpServer>;
 declare function runServer(): Promise<void>;
 //#endregion
 export { configSchema, createServer, createServer as default, runServer };

package/dist/index.mjs

@@ -4,10 +4,10 @@
 (function() {
 	try {
 		var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {};
-		e.SENTRY_RELEASE = { id: "hevy-mcp@1.28.0" };
+		e.SENTRY_RELEASE = { id: "hevy-mcp@2.0.0" };
 		var n = new e.Error().stack;
 		n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "5b077b94-9ef8-4f24-a0b0-8dcfbf491be1", e._sentryDebugIdIdentifier = "sentry-dbid-5b077b94-9ef8-4f24-a0b0-8dcfbf491be1");
 	} catch (e) {}
 })();
-import { n as createServer, r as runServer, t as configSchema } from "./src-J8OsyJcw.mjs";
+import { n as createServer, r as runServer, t as configSchema } from "./src-c3mB-R0m.mjs";
 export { configSchema, createServer, createServer as default, runServer };