hevy-mcp 1.4.0 → 1.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +17 -6
- package/dist/index.js +1215 -1697
- package/dist/index.js.map +1 -1
- package/package.json +30 -24
package/README.md
CHANGED
|
@@ -1,5 +1,3 @@
|
|
|
1
|
-
[](https://mseep.ai/app/chrisdoc-hevy-mcp)
|
|
2
|
-
|
|
3
1
|
# hevy-mcp: Model Context Protocol Server for Hevy Fitness API
|
|
4
2
|
|
|
5
3
|
[](https://opensource.org/licenses/MIT)
|
|
@@ -13,6 +11,7 @@ A Model Context Protocol (MCP) server implementation that interfaces with the [H
|
|
|
13
11
|
- **Routine Management**: Access and manage workout routines
|
|
14
12
|
- **Exercise Templates**: Browse available exercise templates
|
|
15
13
|
- **Folder Organization**: Manage routine folders
|
|
14
|
+
- **Webhook Subscriptions**: Create, view, and delete webhook subscriptions for workout events
|
|
16
15
|
|
|
17
16
|
## Prerequisites
|
|
18
17
|
|
|
@@ -106,7 +105,7 @@ The server implements the following MCP tools for interacting with the Hevy API:
|
|
|
106
105
|
- `get-routines`: Fetch and format routine data
|
|
107
106
|
- `create-routine`: Create a new routine
|
|
108
107
|
- `update-routine`: Update an existing routine
|
|
109
|
-
- `get-routine`: Get a single routine by ID
|
|
108
|
+
- `get-routine-by-id`: Get a single routine by ID using direct endpoint
|
|
110
109
|
|
|
111
110
|
### Exercise Template Tools
|
|
112
111
|
- `get-exercise-templates`: Fetch exercise templates
|
|
@@ -117,6 +116,11 @@ The server implements the following MCP tools for interacting with the Hevy API:
|
|
|
117
116
|
- `create-routine-folder`: Create a new folder
|
|
118
117
|
- `get-routine-folder`: Get a folder by ID
|
|
119
118
|
|
|
119
|
+
### Webhook Tools
|
|
120
|
+
- `get-webhook-subscription`: Get the current webhook subscription
|
|
121
|
+
- `create-webhook-subscription`: Create a new webhook subscription
|
|
122
|
+
- `delete-webhook-subscription`: Delete the current webhook subscription
|
|
123
|
+
|
|
120
124
|
## Project Structure
|
|
121
125
|
|
|
122
126
|
```plaintext
|
|
@@ -128,9 +132,14 @@ hevy-mcp/
|
|
|
128
132
|
│ │ ├── workouts.ts # Workout-related tools
|
|
129
133
|
│ │ ├── routines.ts # Routine-related tools
|
|
130
134
|
│ │ ├── templates.ts # Exercise template tools
|
|
131
|
-
│ │
|
|
135
|
+
│ │ ├── folders.ts # Routine folder tools
|
|
136
|
+
│ │ └── webhooks.ts # Webhook subscription tools
|
|
132
137
|
│ ├── generated/ # API client (generated code)
|
|
133
|
-
│ │ ├── client/ #
|
|
138
|
+
│ │ ├── client/ # Kubb-generated client
|
|
139
|
+
│ │ │ ├── api/ # API client methods
|
|
140
|
+
│ │ │ ├── types/ # TypeScript types
|
|
141
|
+
│ │ │ ├── schemas/ # Zod schemas
|
|
142
|
+
│ │ │ └── mocks/ # Mock data
|
|
134
143
|
│ └── utils/ # Helper utilities
|
|
135
144
|
│ ├── formatters.ts # Data formatting helpers
|
|
136
145
|
│ └── validators.ts # Input validation helpers
|
|
@@ -205,13 +214,15 @@ If the secret is not set, the integration tests step will be skipped with a mess
|
|
|
205
214
|
|
|
206
215
|
### Generating API Client
|
|
207
216
|
|
|
208
|
-
The API client is generated from the OpenAPI specification using [
|
|
217
|
+
The API client is generated from the OpenAPI specification using [Kubb](https://kubb.dev/):
|
|
209
218
|
|
|
210
219
|
```bash
|
|
211
220
|
npm run export-specs
|
|
212
221
|
npm run build:client
|
|
213
222
|
```
|
|
214
223
|
|
|
224
|
+
Kubb generates TypeScript types, API clients, Zod schemas, and mock data from the OpenAPI specification.
|
|
225
|
+
|
|
215
226
|
## License
|
|
216
227
|
|
|
217
228
|
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|