@easingwizard/mcp-server 1.0.7 → 1.2.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/package.json CHANGED
@@ -1,25 +1,16 @@
1
1
  {
2
2
  "name": "@easingwizard/mcp-server",
3
- "version": "1.0.7",
4
- "description": "Model Context Protocol (MCP) server for the Easing Wizard API - enables generation of various CSS easing curves: Bézier, Spring, Bounce, Wiggle, and Overshoot",
3
+ "version": "1.2.0",
4
+ "description": "Local and HTTP MCP tools for generating CSS and Tailwind easing curves",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
7
7
  "bin": {
8
8
  "easingwizard-mcp": "./dist/index.js"
9
9
  },
10
- "scripts": {
11
- "build": "esbuild src/index.ts --bundle --platform=node --target=node18 --format=esm --outfile=dist/index.js --minify",
12
- "build:types": "tsc --emitDeclarationOnly",
13
- "build:full": "pnpm run build && pnpm run build:types",
14
- "watch": "tsc --watch",
15
- "start": "node ./dist/index.js",
16
- "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
17
- "prepublishOnly": "pnpm run build:full"
18
- },
19
10
  "files": [
20
11
  "dist",
21
12
  "README.md",
22
- "../../LICENSE"
13
+ "LICENSE"
23
14
  ],
24
15
  "keywords": [
25
16
  "mcp",
@@ -45,16 +36,40 @@
45
36
  "url": "https://github.com/roydigerhund/easingwizard/issues"
46
37
  },
47
38
  "engines": {
48
- "node": ">=22.0.0"
39
+ "node": ">=22.14.0"
49
40
  },
50
41
  "dependencies": {
51
- "@modelcontextprotocol/sdk": "^1.17.0",
52
- "zod": "^4.0.14"
42
+ "@modelcontextprotocol/server": "^2.4.0",
43
+ "zod": "^4.6.7"
53
44
  },
54
45
  "devDependencies": {
55
- "@types/node": "^24.1.0",
56
- "easingwizard-core": "workspace:*",
57
- "esbuild": "^0.24.0",
58
- "typescript": "^5.8.0"
46
+ "@modelcontextprotocol/client": "^2.4.0",
47
+ "@types/node": "^22.20.5",
48
+ "ajv": "^8.20.0",
49
+ "ajv-formats": "^3.0.1",
50
+ "esbuild": "^0.28.2",
51
+ "typescript": "^5.9.3",
52
+ "easingwizard-core": "1.0.0"
53
+ },
54
+ "exports": {
55
+ "./server": {
56
+ "types": "./dist/server.d.ts",
57
+ "import": "./dist/server.js"
58
+ },
59
+ "./http": {
60
+ "types": "./dist/http.d.ts",
61
+ "import": "./dist/http.js"
62
+ }
63
+ },
64
+ "license": "SEE LICENSE IN LICENSE",
65
+ "scripts": {
66
+ "build": "esbuild src/index.ts src/server.ts src/http.ts --bundle --platform=node --target=node22 --format=esm --outdir=dist --external:@modelcontextprotocol/* --external:zod --external:zod/* && tsc --emitDeclarationOnly",
67
+ "build:types": "tsc --emitDeclarationOnly",
68
+ "build:full": "pnpm build",
69
+ "typecheck": "tsc --noEmit",
70
+ "test": "node --test tests/*.test.mjs",
71
+ "watch": "esbuild src/index.ts src/server.ts src/http.ts --bundle --platform=node --target=node22 --format=esm --outdir=dist --external:@modelcontextprotocol/* --external:zod --external:zod/* --watch",
72
+ "start": "node dist/index.js",
73
+ "inspect": "pnpm dlx @modelcontextprotocol/inspector node dist/index.js"
59
74
  }
60
- }
75
+ }
package/Readme.md DELETED
@@ -1,233 +0,0 @@
1
- # Easing Wizard MCP Server
2
-
3
- A Model Context Protocol (MCP) server for the [Easing Wizard](https://easingwizard.com). This server enables AI assistants to generate various CSS easing curves: Bézier, Spring, Bounce, Wiggle, and Overshoot.
4
-
5
- ## Features
6
-
7
- - **Preset curves**: Access predefined easing curves filtered by type
8
- - **Bézier curves**: Create custom cubic Bézier curves with control points
9
- - **Spring curves**: Physics-based spring animations with mass, stiffness, and damping
10
- - **Bounce curves**: Bouncing animations with configurable bounces and damping
11
- - **Wiggle curves**: Oscillating animations with configurable wiggles and damping
12
- - **Overshoot curves**: Curves that overshoot the target before settling
13
-
14
- ## Setup
15
-
16
- ### Claude Desktop
17
-
18
- Add to your `claude_desktop_config.json`:
19
-
20
- ```json
21
- {
22
- "mcpServers": {
23
- "easingwizard": {
24
- "command": "npx",
25
- "args": ["-y", "@easingwizard/mcp-server"]
26
- }
27
- }
28
- }
29
- ```
30
-
31
- ### VS Code
32
-
33
- Add to your MCP configuration `.vscode/mcp.json`:
34
-
35
- ```json
36
- {
37
- "servers": {
38
- "easingwizard": {
39
- "command": "npx",
40
- "args": ["-y", "@easingwizard/mcp-server"]
41
- }
42
- }
43
- }
44
- ```
45
-
46
- ### Other MCP Clients
47
-
48
- For other MCP-compatible applications, use the standard configuration format:
49
-
50
- ```json
51
- {
52
- "mcpServers": {
53
- "easingwizard": {
54
- "command": "npx",
55
- "args": ["-y", "@easingwizard/mcp-server"]
56
- }
57
- }
58
- }
59
- ```
60
-
61
- ## Available Tools
62
-
63
- The MCP server provides the following tools for AI assistants:
64
-
65
- ### `getPresets`
66
-
67
- Retrieves available preset easing curves, optionally filtered by type.
68
-
69
- **Parameters:**
70
-
71
- - `type` (optional): Filter by easing type (`BEZIER`, `SPRING`, `BOUNCE`, `WIGGLE`, `OVERSHOOT`)
72
-
73
- **Example:**
74
-
75
- ```json
76
- {
77
- "name": "getPresets",
78
- "arguments": {
79
- "type": "BEZIER"
80
- }
81
- }
82
- ```
83
-
84
- ### `getCurveById`
85
-
86
- Retrieves a specific easing curve by its unique ID.
87
-
88
- **Parameters:**
89
-
90
- - `id` (required): The unique ID of the easing curve
91
-
92
- **Example:**
93
-
94
- ```json
95
- {
96
- "name": "getCurveById",
97
- "arguments": {
98
- "id": "0a0d.25e.1f.75g.914"
99
- }
100
- }
101
- ```
102
-
103
- ### `createBezierCurve`
104
-
105
- Creates a custom cubic Bézier easing curve.
106
-
107
- **Parameters:**
108
-
109
- - `x1` (0-1): First control point X coordinate
110
- - `y1` (-1 to 2): First control point Y coordinate
111
- - `x2` (0-1): Second control point X coordinate
112
- - `y2` (-1 to 2): Second control point Y coordinate
113
-
114
- **Example:**
115
-
116
- ```json
117
- {
118
- "name": "createBezierCurve",
119
- "arguments": {
120
- "x1": 0.25,
121
- "y1": 0.1,
122
- "x2": 0.75,
123
- "y2": 0.9
124
- }
125
- }
126
- ```
127
-
128
- ### `createSpringCurve`
129
-
130
- Creates a spring-based easing curve with physics parameters.
131
-
132
- **Parameters:**
133
-
134
- - `mass` (1-5): Mass of the spring system
135
- - `stiffness` (0-100): Spring stiffness
136
- - `damping` (0-100): Damping force
137
- - `accuracy` (`LOW`, `MEDIUM`, `HIGH`, `ULTRA`): Calculation precision
138
-
139
- **Example:**
140
-
141
- ```json
142
- {
143
- "name": "createSpringCurve",
144
- "arguments": {
145
- "mass": 2.5,
146
- "stiffness": 50,
147
- "damping": 50,
148
- "accuracy": "HIGH"
149
- }
150
- }
151
- ```
152
-
153
- ### `createBounceCurve`
154
-
155
- Creates a bouncing easing curve.
156
-
157
- **Parameters:**
158
-
159
- - `bounces` (1-10): Number of bounces
160
- - `damping` (0-100): Bounce damping
161
- - `accuracy` (`LOW`, `MEDIUM`, `HIGH`, `ULTRA`): Calculation precision
162
-
163
- ### `createWiggleCurve`
164
-
165
- Creates an oscillating wiggle curve.
166
-
167
- **Parameters:**
168
-
169
- - `wiggles` (1-10): Number of oscillations
170
- - `damping` (0-100): Oscillation damping
171
- - `accuracy` (`LOW`, `MEDIUM`, `HIGH`, `ULTRA`): Calculation precision
172
-
173
- ### `createOvershootCurve`
174
-
175
- Creates an overshoot easing curve.
176
-
177
- **Parameters:**
178
-
179
- - `style` (`IN`, `OUT`, `IN_OUT`): Animation style
180
- - `mass` (1-5): Mass parameter
181
- - `damping` (0-100): Damping force
182
- - `accuracy` (`LOW`, `MEDIUM`, `HIGH`, `ULTRA`): Calculation precision
183
-
184
- ## Output Formats
185
-
186
- All easing curve tools return comprehensive data including:
187
-
188
- - **CSS Functions**: Ready-to-use `cubic-bezier()` or `linear()` functions
189
- - **Tailwind CSS**: Compatible easing class names
190
- - **SVG Paths**: Vector graphics for curve visualization
191
- - **Metadata**: Unique IDs, timestamps, and reference links
192
-
193
- ## Development
194
-
195
- If you want to contribute or modify the server:
196
-
197
- ```bash
198
- # Clone the repository
199
- git clone https://github.com/roydigerhund/easingwizard.git
200
- cd easingwizard/apps/mcp
201
-
202
- # Install dependencies
203
- pnpm install
204
-
205
- # Build the server
206
- pnpm build
207
-
208
- # Test the server
209
- pnpm watch
210
-
211
- # Inspect the MCP tool
212
- pnpm inspect
213
- ```
214
-
215
- ## Error Handling
216
-
217
- The server provides detailed error messages for:
218
-
219
- - Invalid parameter ranges or types
220
- - Malformed curve configurations
221
- - MCP protocol errors
222
- - Internal processing failures
223
-
224
- ## License
225
-
226
- MIT License - see [LICENSE](LICENSE) file for details.
227
-
228
- ## Links
229
-
230
- - **Website**: [Easing Wizard](https://easingwizard.com)
231
- - **Repository**: [GitHub](https://github.com/roydigerhund/easingwizard)
232
- - **Issues**: [Report bugs](https://github.com/roydigerhund/easingwizard/issues)
233
- - **MCP Protocol**: [Model Context Protocol](https://modelcontextprotocol.io)