make-mcp-server 1.3.2 → 1.3.4

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.
Files changed (4) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +351 -349
  3. package/data/make-modules.db +0 -0
  4. package/package.json +2 -2
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Daniel Shashko
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2025 MCP Contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,349 +1,351 @@
1
- # Make.com MCP Server — Build & Deploy Automation Scenarios with AI
2
-
3
- [![npm version](https://img.shields.io/npm/v/make-mcp-server)](https://www.npmjs.com/package/make-mcp-server)
4
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
-
6
- A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that gives AI assistants like **Claude**, **GitHub Copilot**, and **Cursor** full access to Make.com module documentation, scenario validation, and one-click deployment. Search 200+ automation modules across 40+ apps, build blueprints with auto-healing, and deploy directly to Make.com — all from your AI chat.
7
-
8
- ## Features
9
-
10
- - **🔍 200+ Modules** — Full-text search across 200+ Make.com modules (Slack, Gmail, Google Sheets, Notion, OpenAI, and 35+ more apps)
11
- - **📋 Module Details** — Retrieve parameters, types, descriptions, and usage docs for any module
12
- - **✅ Blueprint Validation** — Check scenarios for missing parameters, unknown modules, structural issues, and router sub-routes before deploying
13
- - **🚀 Deploy to Make.com** — Push validated blueprints directly to Make.com via API
14
- - **🩹 Auto-Healing** — Automatically fixes LLM-generated blueprints: injects missing `metadata`, adds `designer` coordinates, strips unsupported properties like router `filter`
15
- - **🔀 Router Support** — Full support for `builtin:BasicRouter` with multiple routes and recursive validation
16
- - **📚 Scenario Templates** — Browse reusable scenario templates for common workflows
17
- - **📖 Guided Prompts** — MCP prompts for guided scenario building and module exploration
18
- - **📊 Resource Catalog** — MCP resources for browsing available apps
19
- - **🧪 42 Tests** — Unit + integration test suite with Vitest
20
- - **⚡ Fast Response** — Optimized SQLite with FTS5 full-text search
21
-
22
- ---
23
-
24
- ## 🚀 Quick Start — Self-Hosting Options
25
-
26
- ### Option A: npx (No Installation Needed!) 🚀
27
-
28
- The fastest way to get started — no cloning, no building:
29
-
30
- **Prerequisites:** [Node.js](https://nodejs.org/) installed on your system
31
-
32
- ```bash
33
- # Run directly — no installation needed!
34
- npx -y make-mcp-server
35
- ```
36
-
37
- The package includes a pre-built database with all 200+ Make.com modules. Just add it to your MCP client config and go.
38
-
39
- **Claude Desktop config** (`claude_desktop_config.json`):
40
-
41
- Basic configuration (documentation tools only):
42
-
43
- ```json
44
- {
45
- "mcpServers": {
46
- "make-mcp-server": {
47
- "command": "npx",
48
- "args": ["-y", "make-mcp-server"],
49
- "env": {
50
- "LOG_LEVEL": "error"
51
- }
52
- }
53
- }
54
- }
55
- ```
56
-
57
- Full configuration (with Make.com deployment):
58
-
59
- ```json
60
- {
61
- "mcpServers": {
62
- "make-mcp-server": {
63
- "command": "npx",
64
- "args": ["-y", "make-mcp-server"],
65
- "env": {
66
- "LOG_LEVEL": "error",
67
- "MAKE_API_KEY": "your_api_key_here",
68
- "MAKE_TEAM_ID": "your_team_id",
69
- "MAKE_API_URL": "https://eu1.make.com/api/v2"
70
- }
71
- }
72
- }
73
- }
74
- ```
75
-
76
- > **Note:** npx will download and cache the latest version automatically. The package includes a pre-built database with all Make.com module information — no setup required.
77
-
78
- ---
79
-
80
- ### Option B: Docker (Isolated & Reproducible) 🐳
81
-
82
- **Prerequisites:** Docker installed on your system
83
-
84
- ```bash
85
- # Build the Docker image
86
- docker build -t make-mcp-server .
87
-
88
- # Test it works
89
- echo '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}},"id":1}' | docker run -i --rm make-mcp-server
90
- ```
91
-
92
- **Claude Desktop config:**
93
-
94
- Basic configuration (documentation tools only):
95
-
96
- ```json
97
- {
98
- "mcpServers": {
99
- "make-mcp-server": {
100
- "command": "docker",
101
- "args": [
102
- "run", "-i", "--rm", "--init",
103
- "-e", "LOG_LEVEL=error",
104
- "make-mcp-server"
105
- ]
106
- }
107
- }
108
- }
109
- ```
110
-
111
- Full configuration (with Make.com deployment):
112
-
113
- ```json
114
- {
115
- "mcpServers": {
116
- "make-mcp-server": {
117
- "command": "docker",
118
- "args": [
119
- "run", "-i", "--rm", "--init",
120
- "-e", "LOG_LEVEL=error",
121
- "-e", "MAKE_API_KEY=your_api_key_here",
122
- "-e", "MAKE_TEAM_ID=your_team_id",
123
- "-e", "MAKE_API_URL=https://eu1.make.com/api/v2",
124
- "make-mcp-server"
125
- ]
126
- }
127
- }
128
- }
129
- ```
130
-
131
- > **Important:** The `-i` flag is required for MCP stdio communication.
132
-
133
- ---
134
-
135
- ### Option C: Local Installation (For Development) 🛠️
136
-
137
- **Prerequisites:** [Node.js](https://nodejs.org/) and Git
138
-
139
- ```bash
140
- # 1. Clone and install
141
- git clone https://github.com/danishashko/make-mcp.git
142
- cd make-mcp
143
- npm install
144
-
145
- # 2. Build
146
- npm run build
147
-
148
- # 3. Populate the module database (already done if using npm package)
149
- npm run scrape:prod
150
-
151
- # 4. Test it works
152
- npm start
153
- ```
154
-
155
- **Claude Desktop config:**
156
-
157
- ```json
158
- {
159
- "mcpServers": {
160
- "make-mcp-server": {
161
- "command": "node",
162
- "args": ["/absolute/path/to/make-mcp/dist/mcp/server.js"],
163
- "env": {
164
- "LOG_LEVEL": "error",
165
- "MAKE_API_KEY": "your_api_key_here",
166
- "MAKE_TEAM_ID": "your_team_id"
167
- }
168
- }
169
- }
170
- }
171
- ```
172
-
173
- > **Note:** The Make.com API credentials are optional. Without them, you'll have access to all documentation, search, and validation tools. With them, you'll additionally get scenario deployment capabilities.
174
-
175
- ---
176
-
177
- ### Configuration File Locations
178
-
179
- | Platform | Path |
180
- |----------|------|
181
- | macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
182
- | Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
183
- | Linux | `~/.config/Claude/claude_desktop_config.json` |
184
-
185
- **Restart Claude Desktop after updating configuration.**
186
-
187
- ---
188
-
189
- ### 💻 Connect Your IDE
190
-
191
- make-mcp-server works with any MCP-compatible client:
192
-
193
- - **Claude Desktop** — See configurations above
194
- - **VS Code (GitHub Copilot)** — Add to `.vscode/mcp.json`
195
- - **Cursor** — Add to MCP settings
196
- - **Claude Code** — Use `claude mcp add` command
197
- - **Windsurf** — Add to MCP configuration
198
-
199
- ---
200
-
201
- ## Usage
202
-
203
- Then ask your AI assistant things like:
204
-
205
- > "Create a Make scenario that watches a Slack channel for new messages and logs them to a Google Sheet"
206
-
207
- > "What modules does Make have for sending emails?"
208
-
209
- > "Validate this scenario blueprint..."
210
-
211
- **Tip:** The AI will automatically call `tools_documentation` first to understand how to use the server effectively.
212
-
213
- ## Available Tools
214
-
215
- | Tool | Description |
216
- |------|-------------|
217
- | `tools_documentation` | **START HERE** — Returns comprehensive documentation for all tools, prompts, and resources |
218
- | `search_modules` | Full-text search across 200+ Make.com modules |
219
- | `get_module` | Get detailed module info with parameters and docs |
220
- | `validate_scenario` | Validate a scenario blueprint before deployment |
221
- | `create_scenario` | Deploy a scenario to Make.com via API |
222
- | `search_templates` | Search reusable scenario templates |
223
- | `list_apps` | List all apps with module counts |
224
-
225
- ## Auto-Healing
226
-
227
- The `create_scenario` tool automatically fixes common issues in LLM-generated blueprints:
228
-
229
- | Issue | Auto-Fix |
230
- |-------|----------|
231
- | Missing `metadata` section | Injects full metadata with `version`, `scenario` config, and `designer` |
232
- | Missing `metadata.designer` on modules | Adds `{ x: 0, y: 0 }` coordinates |
233
- | Router `filter` in route objects | Strips unsupported `filter` property (configure filters in Make.com UI) |
234
- | Missing `version` on modules | Left unset — Make.com auto-resolves the latest installed version |
235
-
236
- > **Tip:** Do NOT hardcode `"version": 1` on modules. Some apps (e.g., HTTP) are on v4+ and specifying the wrong version causes "Module not found" errors.
237
-
238
- ## MCP Prompts
239
-
240
- | Prompt | Description |
241
- |--------|-------------|
242
- | `build_scenario` | Guided workflow for creating a Make.com scenario from a natural language description |
243
- | `explain_module` | Get a detailed explanation of any Make.com module with usage examples |
244
-
245
- ## MCP Resources
246
-
247
- | Resource URI | Description |
248
- |-------------|-------------|
249
- | `make://apps` | List of all available apps with module counts |
250
-
251
- ## CLI Usage
252
-
253
- ```bash
254
- make-mcp-server # Start the MCP server (stdio transport)
255
- make-mcp-server --scrape # Populate/refresh the module database
256
- make-mcp-server --version # Print version
257
- make-mcp-server --help # Show help
258
- ```
259
-
260
- ## Environment Variables
261
-
262
- | Variable | Required | Default | Description |
263
- |----------|----------|---------|-------------|
264
- | `MAKE_API_KEY` | For deployment | — | Make.com API key |
265
- | `MAKE_API_URL` | No | `https://eu1.make.com/api/v2` | Make.com API base URL |
266
- | `MAKE_TEAM_ID` | For deployment | — | Default team ID for scenario deployment |
267
- | `DATABASE_PATH` | No | `<package>/data/make-modules.db` | SQLite database file path |
268
- | `LOG_LEVEL` | No | `info` | Logging level: `debug`, `info`, `warn`, `error`, `silent` |
269
-
270
- ## Development
271
-
272
- ```bash
273
- npm run build # Compile TypeScript + copy schema + add shebang
274
- npm run build:tsc # TypeScript only (no packaging)
275
- npm run start:dev # Start with tsx (no build needed)
276
- npm run dev # Start with file watching
277
- npm run scrape # Populate DB with tsx (dev)
278
- npm run scrape:prod # Populate DB from compiled JS
279
- npm test # Run all 42 tests
280
- npm run test:watch # Run tests in watch mode
281
- ```
282
-
283
- ### Publishing to npm
284
-
285
- ```bash
286
- npm run prepublishOnly # Build + populate DB + verify (runs automatically on npm publish)
287
- npm publish # Publish to npm registry
288
- ```
289
-
290
- ## Testing
291
-
292
- The test suite includes 42 tests across 3 files:
293
-
294
- - **Database tests** (14 tests) — Insert, search, template operations, FTS5 queries
295
- - **Logger tests** (7 tests) — Stderr-only output, log levels, data serialization
296
- - **Server integration tests** (21 tests) — Full MCP protocol compliance via SDK client
297
-
298
- ```bash
299
- npm test
300
- ```
301
-
302
- ## Architecture
303
-
304
- ```
305
- src/
306
- ├── mcp/
307
- │ └── server.ts # MCP server with tools, prompts, resources
308
- ├── database/
309
- │ ├── schema.sql # SQLite + FTS5 schema
310
- │ └── db.ts # Database access layer (npx-safe path resolution)
311
- ├── scrapers/
312
- │ └── scrape-modules.ts # Module data population (224 modules)
313
- └── utils/
314
- └── logger.ts # Structured stderr-only logger
315
- bin/
316
- ├── make-mcp.js # CLI entry point (npx, --help, --version, --scrape)
317
- └── postinstall.js # Post-install verification
318
- scripts/
319
- ├── build.js # Build: tsc + copy schema + add shebang
320
- └── prepublish.js # Publish prep: build + populate DB + verify
321
- data/
322
- └── make-modules.db # Pre-built SQLite database (bundled in npm package)
323
- tests/
324
- ├── database.test.ts # Database unit tests (14)
325
- ├── logger.test.ts # Logger unit tests (7)
326
- └── server.test.ts # MCP integration tests (21)
327
- Dockerfile # Multi-stage Docker image
328
- ```
329
-
330
- ## Tech Stack
331
-
332
- - **TypeScript** + **Node.js** (ESM)
333
- - **@modelcontextprotocol/sdk** v1.26.0 — MCP protocol implementation
334
- - **better-sqlite3** — Synchronous SQLite with FTS5 full-text search
335
- - **zod** — Schema validation for tool parameters
336
- - **axios** — HTTP client for Make.com API
337
- - **vitest** — Test framework
338
-
339
- ## Supported Apps (40+)
340
-
341
- Google Sheets, Slack, OpenAI, Google Drive, Notion, Telegram Bot, HubSpot CRM, Gmail, Airtable, Tools, Flow Control, Google Calendar, Jira, Trello, Shopify, Google Docs, Microsoft Teams, Microsoft Outlook, Discord, Asana, monday.com, Salesforce, Stripe, GitHub, HTTP, Mailchimp, WordPress, Dropbox, Data Store, JSON, Twilio, Google Gemini AI, WhatsApp Business, Text Parser, Webhooks, Anthropic Claude, CSV, RSS, Email, Schedule
342
-
343
- ## Author
344
-
345
- Built by **[Daniel Shashko](https://www.linkedin.com/in/daniel-shashko/)**
346
-
347
- ## License
348
-
349
- MIT License — see [LICENSE](LICENSE) for details.
1
+ # Make.com MCP Server — Build & Deploy Automation Scenarios with AI
2
+
3
+ [![npm version](https://img.shields.io/npm/v/make-mcp-server)](https://www.npmjs.com/package/make-mcp-server)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
+
6
+ > **⚠️ Disclaimer:** This is an **unofficial, community-driven project** created by a passionate fan of Make.com. It is **NOT** affiliated with, endorsed by, or officially supported by Make.com.
7
+
8
+ A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that gives AI assistants like **Claude**, **GitHub Copilot**, and **Cursor** full access to Make.com module documentation, scenario validation, and one-click deployment. Search 200+ automation modules across 40+ apps, build blueprints with auto-healing, and deploy directly to Make.com — all from your AI chat.
9
+
10
+ ## Features
11
+
12
+ - **🔍 200+ Modules** — Full-text search across 200+ Make.com modules (Slack, Gmail, Google Sheets, Notion, OpenAI, and 35+ more apps)
13
+ - **📋 Module Details** — Retrieve parameters, types, descriptions, and usage docs for any module
14
+ - **✅ Blueprint Validation** — Check scenarios for missing parameters, unknown modules, structural issues, and router sub-routes before deploying
15
+ - **🚀 Deploy to Make.com** — Push validated blueprints directly to Make.com via API
16
+ - **🩹 Auto-Healing** — Automatically fixes LLM-generated blueprints: injects missing `metadata`, adds `designer` coordinates, strips unsupported properties like router `filter`
17
+ - **🔀 Router Support** — Full support for `builtin:BasicRouter` with multiple routes and recursive validation
18
+ - **📚 Scenario Templates** — Browse reusable scenario templates for common workflows
19
+ - **📖 Guided Prompts** — MCP prompts for guided scenario building and module exploration
20
+ - **📊 Resource Catalog** — MCP resources for browsing available apps
21
+ - **🧪 42 Tests** — Unit + integration test suite with Vitest
22
+ - **⚡ Fast Response** — Optimized SQLite with FTS5 full-text search
23
+
24
+ ---
25
+
26
+ ## 🚀 Quick Start — Self-Hosting Options
27
+
28
+ ### Option A: npx (No Installation Needed!) 🚀
29
+
30
+ The fastest way to get started — no cloning, no building:
31
+
32
+ **Prerequisites:** [Node.js](https://nodejs.org/) installed on your system
33
+
34
+ ```bash
35
+ # Run directly — no installation needed!
36
+ npx -y make-mcp-server
37
+ ```
38
+
39
+ The package includes a pre-built database with all 200+ Make.com modules. Just add it to your MCP client config and go.
40
+
41
+ **Claude Desktop config** (`claude_desktop_config.json`):
42
+
43
+ Basic configuration (documentation tools only):
44
+
45
+ ```json
46
+ {
47
+ "mcpServers": {
48
+ "make-mcp-server": {
49
+ "command": "npx",
50
+ "args": ["-y", "make-mcp-server"],
51
+ "env": {
52
+ "LOG_LEVEL": "error"
53
+ }
54
+ }
55
+ }
56
+ }
57
+ ```
58
+
59
+ Full configuration (with Make.com deployment):
60
+
61
+ ```json
62
+ {
63
+ "mcpServers": {
64
+ "make-mcp-server": {
65
+ "command": "npx",
66
+ "args": ["-y", "make-mcp-server"],
67
+ "env": {
68
+ "LOG_LEVEL": "error",
69
+ "MAKE_API_KEY": "your_api_key_here",
70
+ "MAKE_TEAM_ID": "your_team_id",
71
+ "MAKE_API_URL": "https://eu1.make.com/api/v2"
72
+ }
73
+ }
74
+ }
75
+ }
76
+ ```
77
+
78
+ > **Note:** npx will download and cache the latest version automatically. The package includes a pre-built database with all Make.com module information — no setup required.
79
+
80
+ ---
81
+
82
+ ### Option B: Docker (Isolated & Reproducible) 🐳
83
+
84
+ **Prerequisites:** Docker installed on your system
85
+
86
+ ```bash
87
+ # Build the Docker image
88
+ docker build -t make-mcp-server .
89
+
90
+ # Test it works
91
+ echo '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}},"id":1}' | docker run -i --rm make-mcp-server
92
+ ```
93
+
94
+ **Claude Desktop config:**
95
+
96
+ Basic configuration (documentation tools only):
97
+
98
+ ```json
99
+ {
100
+ "mcpServers": {
101
+ "make-mcp-server": {
102
+ "command": "docker",
103
+ "args": [
104
+ "run", "-i", "--rm", "--init",
105
+ "-e", "LOG_LEVEL=error",
106
+ "make-mcp-server"
107
+ ]
108
+ }
109
+ }
110
+ }
111
+ ```
112
+
113
+ Full configuration (with Make.com deployment):
114
+
115
+ ```json
116
+ {
117
+ "mcpServers": {
118
+ "make-mcp-server": {
119
+ "command": "docker",
120
+ "args": [
121
+ "run", "-i", "--rm", "--init",
122
+ "-e", "LOG_LEVEL=error",
123
+ "-e", "MAKE_API_KEY=your_api_key_here",
124
+ "-e", "MAKE_TEAM_ID=your_team_id",
125
+ "-e", "MAKE_API_URL=https://eu1.make.com/api/v2",
126
+ "make-mcp-server"
127
+ ]
128
+ }
129
+ }
130
+ }
131
+ ```
132
+
133
+ > **Important:** The `-i` flag is required for MCP stdio communication.
134
+
135
+ ---
136
+
137
+ ### Option C: Local Installation (For Development) 🛠️
138
+
139
+ **Prerequisites:** [Node.js](https://nodejs.org/) and Git
140
+
141
+ ```bash
142
+ # 1. Clone and install
143
+ git clone https://github.com/danishashko/make-mcp.git
144
+ cd make-mcp
145
+ npm install
146
+
147
+ # 2. Build
148
+ npm run build
149
+
150
+ # 3. Populate the module database (already done if using npm package)
151
+ npm run scrape:prod
152
+
153
+ # 4. Test it works
154
+ npm start
155
+ ```
156
+
157
+ **Claude Desktop config:**
158
+
159
+ ```json
160
+ {
161
+ "mcpServers": {
162
+ "make-mcp-server": {
163
+ "command": "node",
164
+ "args": ["/absolute/path/to/make-mcp/dist/mcp/server.js"],
165
+ "env": {
166
+ "LOG_LEVEL": "error",
167
+ "MAKE_API_KEY": "your_api_key_here",
168
+ "MAKE_TEAM_ID": "your_team_id"
169
+ }
170
+ }
171
+ }
172
+ }
173
+ ```
174
+
175
+ > **Note:** The Make.com API credentials are optional. Without them, you'll have access to all documentation, search, and validation tools. With them, you'll additionally get scenario deployment capabilities.
176
+
177
+ ---
178
+
179
+ ### Configuration File Locations
180
+
181
+ | Platform | Path |
182
+ |----------|------|
183
+ | macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
184
+ | Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
185
+ | Linux | `~/.config/Claude/claude_desktop_config.json` |
186
+
187
+ **Restart Claude Desktop after updating configuration.**
188
+
189
+ ---
190
+
191
+ ### 💻 Connect Your IDE
192
+
193
+ make-mcp-server works with any MCP-compatible client:
194
+
195
+ - **Claude Desktop** — See configurations above
196
+ - **VS Code (GitHub Copilot)** — Add to `.vscode/mcp.json`
197
+ - **Cursor** — Add to MCP settings
198
+ - **Claude Code** — Use `claude mcp add` command
199
+ - **Windsurf** — Add to MCP configuration
200
+
201
+ ---
202
+
203
+ ## Usage
204
+
205
+ Then ask your AI assistant things like:
206
+
207
+ > "Create a Make scenario that watches a Slack channel for new messages and logs them to a Google Sheet"
208
+
209
+ > "What modules does Make have for sending emails?"
210
+
211
+ > "Validate this scenario blueprint..."
212
+
213
+ **Tip:** The AI will automatically call `tools_documentation` first to understand how to use the server effectively.
214
+
215
+ ## Available Tools
216
+
217
+ | Tool | Description |
218
+ |------|-------------|
219
+ | `tools_documentation` | **START HERE** — Returns comprehensive documentation for all tools, prompts, and resources |
220
+ | `search_modules` | Full-text search across 200+ Make.com modules |
221
+ | `get_module` | Get detailed module info with parameters and docs |
222
+ | `validate_scenario` | Validate a scenario blueprint before deployment |
223
+ | `create_scenario` | Deploy a scenario to Make.com via API |
224
+ | `search_templates` | Search reusable scenario templates |
225
+ | `list_apps` | List all apps with module counts |
226
+
227
+ ## Auto-Healing
228
+
229
+ The `create_scenario` tool automatically fixes common issues in LLM-generated blueprints:
230
+
231
+ | Issue | Auto-Fix |
232
+ |-------|----------|
233
+ | Missing `metadata` section | Injects full metadata with `version`, `scenario` config, and `designer` |
234
+ | Missing `metadata.designer` on modules | Adds `{ x: 0, y: 0 }` coordinates |
235
+ | Router `filter` in route objects | Strips unsupported `filter` property (configure filters in Make.com UI) |
236
+ | Missing `version` on modules | Left unset — Make.com auto-resolves the latest installed version |
237
+
238
+ > **Tip:** Do NOT hardcode `"version": 1` on modules. Some apps (e.g., HTTP) are on v4+ and specifying the wrong version causes "Module not found" errors.
239
+
240
+ ## MCP Prompts
241
+
242
+ | Prompt | Description |
243
+ |--------|-------------|
244
+ | `build_scenario` | Guided workflow for creating a Make.com scenario from a natural language description |
245
+ | `explain_module` | Get a detailed explanation of any Make.com module with usage examples |
246
+
247
+ ## MCP Resources
248
+
249
+ | Resource URI | Description |
250
+ |-------------|-------------|
251
+ | `make://apps` | List of all available apps with module counts |
252
+
253
+ ## CLI Usage
254
+
255
+ ```bash
256
+ make-mcp-server # Start the MCP server (stdio transport)
257
+ make-mcp-server --scrape # Populate/refresh the module database
258
+ make-mcp-server --version # Print version
259
+ make-mcp-server --help # Show help
260
+ ```
261
+
262
+ ## Environment Variables
263
+
264
+ | Variable | Required | Default | Description |
265
+ |----------|----------|---------|-------------|
266
+ | `MAKE_API_KEY` | For deployment | — | Make.com API key |
267
+ | `MAKE_API_URL` | No | `https://eu1.make.com/api/v2` | Make.com API base URL |
268
+ | `MAKE_TEAM_ID` | For deployment | — | Default team ID for scenario deployment |
269
+ | `DATABASE_PATH` | No | `<package>/data/make-modules.db` | SQLite database file path |
270
+ | `LOG_LEVEL` | No | `info` | Logging level: `debug`, `info`, `warn`, `error`, `silent` |
271
+
272
+ ## Development
273
+
274
+ ```bash
275
+ npm run build # Compile TypeScript + copy schema + add shebang
276
+ npm run build:tsc # TypeScript only (no packaging)
277
+ npm run start:dev # Start with tsx (no build needed)
278
+ npm run dev # Start with file watching
279
+ npm run scrape # Populate DB with tsx (dev)
280
+ npm run scrape:prod # Populate DB from compiled JS
281
+ npm test # Run all 42 tests
282
+ npm run test:watch # Run tests in watch mode
283
+ ```
284
+
285
+ ### Publishing to npm
286
+
287
+ ```bash
288
+ npm run prepublishOnly # Build + populate DB + verify (runs automatically on npm publish)
289
+ npm publish # Publish to npm registry
290
+ ```
291
+
292
+ ## Testing
293
+
294
+ The test suite includes 42 tests across 3 files:
295
+
296
+ - **Database tests** (14 tests) — Insert, search, template operations, FTS5 queries
297
+ - **Logger tests** (7 tests) — Stderr-only output, log levels, data serialization
298
+ - **Server integration tests** (21 tests) — Full MCP protocol compliance via SDK client
299
+
300
+ ```bash
301
+ npm test
302
+ ```
303
+
304
+ ## Architecture
305
+
306
+ ```
307
+ src/
308
+ ├── mcp/
309
+ │ └── server.ts # MCP server with tools, prompts, resources
310
+ ├── database/
311
+ │ ├── schema.sql # SQLite + FTS5 schema
312
+ │ └── db.ts # Database access layer (npx-safe path resolution)
313
+ ├── scrapers/
314
+ │ └── scrape-modules.ts # Module data population (224 modules)
315
+ └── utils/
316
+ └── logger.ts # Structured stderr-only logger
317
+ bin/
318
+ ├── make-mcp.js # CLI entry point (npx, --help, --version, --scrape)
319
+ └── postinstall.js # Post-install verification
320
+ scripts/
321
+ ├── build.js # Build: tsc + copy schema + add shebang
322
+ └── prepublish.js # Publish prep: build + populate DB + verify
323
+ data/
324
+ └── make-modules.db # Pre-built SQLite database (bundled in npm package)
325
+ tests/
326
+ ├── database.test.ts # Database unit tests (14)
327
+ ├── logger.test.ts # Logger unit tests (7)
328
+ └── server.test.ts # MCP integration tests (21)
329
+ Dockerfile # Multi-stage Docker image
330
+ ```
331
+
332
+ ## Tech Stack
333
+
334
+ - **TypeScript** + **Node.js** (ESM)
335
+ - **@modelcontextprotocol/sdk** v1.26.0 — MCP protocol implementation
336
+ - **better-sqlite3** — Synchronous SQLite with FTS5 full-text search
337
+ - **zod** — Schema validation for tool parameters
338
+ - **axios** — HTTP client for Make.com API
339
+ - **vitest** — Test framework
340
+
341
+ ## Supported Apps (40+)
342
+
343
+ Google Sheets, Slack, OpenAI, Google Drive, Notion, Telegram Bot, HubSpot CRM, Gmail, Airtable, Tools, Flow Control, Google Calendar, Jira, Trello, Shopify, Google Docs, Microsoft Teams, Microsoft Outlook, Discord, Asana, monday.com, Salesforce, Stripe, GitHub, HTTP, Mailchimp, WordPress, Dropbox, Data Store, JSON, Twilio, Google Gemini AI, WhatsApp Business, Text Parser, Webhooks, Anthropic Claude, CSV, RSS, Email, Schedule
344
+
345
+ ## Author
346
+
347
+ Built by **[Daniel Shashko](https://www.linkedin.com/in/daniel-shashko/)**
348
+
349
+ ## License
350
+
351
+ MIT License — see [LICENSE](LICENSE) for details.
package/data/make-modules.db CHANGED
Binary file
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "make-mcp-server",
3
- "version": "1.3.2",
3
+ "version": "1.3.4",
4
4
  "mcpName": "io.github.danishashko/make-mcp",
5
- "description": "MCP server for creating, validating, and deploying Make.com automation scenarios via AI assistants",
5
+ "description": "Unofficial MCP server for Make.com — build, validate & deploy automation scenarios via AI (community project, not affiliated with Make.com)",
6
6
  "main": "dist/mcp/server.js",
7
7
  "types": "dist/mcp/server.d.ts",
8
8
  "type": "module",