@dropins/mcp 0.1.0 → 0.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/README.md +25 -12
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -6,13 +6,7 @@ MCP server that gives AI assistants deep knowledge of Adobe Commerce drop-in com
|
|
|
6
6
|
|
|
7
7
|
## Getting started
|
|
8
8
|
|
|
9
|
-
### 1.
|
|
10
|
-
|
|
11
|
-
```bash
|
|
12
|
-
npm install -g @dropins/mcp
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
### 2. Configure your IDE
|
|
9
|
+
### 1. Configure your IDE
|
|
16
10
|
|
|
17
11
|
The MCP server runs automatically — your IDE spawns the process when needed. The AI passes your project path directly when calling tools that need it.
|
|
18
12
|
|
|
@@ -49,19 +43,30 @@ Add to `.vscode/mcp.json` in your project:
|
|
|
49
43
|
|
|
50
44
|
#### Claude Desktop
|
|
51
45
|
|
|
52
|
-
|
|
46
|
+
Claude Desktop spawns processes without the shell's PATH, so `npx` may not resolve. Use the installed binary directly instead:
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
npm install -g @dropins/mcp
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
Then add to `claude_desktop_config.json`:
|
|
53
53
|
|
|
54
54
|
```json
|
|
55
55
|
{
|
|
56
56
|
"mcpServers": {
|
|
57
57
|
"dropins": {
|
|
58
|
-
"command": "
|
|
59
|
-
"args": ["@dropins/mcp"]
|
|
58
|
+
"command": "dropins-mcp"
|
|
60
59
|
}
|
|
61
60
|
}
|
|
62
61
|
}
|
|
63
62
|
```
|
|
64
63
|
|
|
64
|
+
If you use `nvm`, replace `dropins-mcp` with the full path to the binary. Run `node --version` to find your version (for example `v22.14.0`):
|
|
65
|
+
|
|
66
|
+
```text
|
|
67
|
+
~/.nvm/versions/node/<version>/bin/dropins-mcp
|
|
68
|
+
```
|
|
69
|
+
|
|
65
70
|
#### Codex
|
|
66
71
|
|
|
67
72
|
Add this to `~/.codex/config.toml`:
|
|
@@ -72,7 +77,7 @@ command = "npx"
|
|
|
72
77
|
args = ["@dropins/mcp"]
|
|
73
78
|
```
|
|
74
79
|
|
|
75
|
-
###
|
|
80
|
+
### 2. (Optional) Enable AI-powered documentation search
|
|
76
81
|
|
|
77
82
|
For enhanced semantic search across Adobe Commerce documentation, install the aio CLI:
|
|
78
83
|
|
|
@@ -83,12 +88,20 @@ aio auth login
|
|
|
83
88
|
|
|
84
89
|
This enables the `search_commerce_docs` tool. Without aio CLI, the MCP works fully — local documentation snapshots are always available via `search_docs`.
|
|
85
90
|
|
|
86
|
-
###
|
|
91
|
+
### 3. Verify
|
|
87
92
|
|
|
88
93
|
Restart your IDE. The dropins MCP should appear with 20 tools and resources enabled. Try a prompt like _"What slots does the CartSummaryList container have?"_ to confirm it works.
|
|
89
94
|
|
|
95
|
+
If the server does not appear, open your IDE's MCP logs and confirm that `npx @dropins/mcp` runs without errors in a terminal outside the IDE.
|
|
96
|
+
|
|
90
97
|
> **Note:** You do not need to clone any drop-in repositories. The knowledge base (registry, docs, examples) is pre-generated and committed to this repo. CI validates it on every push.
|
|
91
98
|
|
|
99
|
+
### Troubleshooting: npx timeout on first run
|
|
100
|
+
|
|
101
|
+
The first time `npx @dropins/mcp` runs it downloads the package, which can take several seconds. Some IDEs have a short MCP startup timeout and report a connection failure before the download completes.
|
|
102
|
+
|
|
103
|
+
To avoid this, install globally first and use the binary directly (see Claude Desktop config above). For other IDEs using `npx`, after the first run the package is cached locally and subsequent startups are fast.
|
|
104
|
+
|
|
92
105
|
## Tools
|
|
93
106
|
|
|
94
107
|
| Tool | Description |
|
package/package.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dropins/mcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "MCP server for Adobe Commerce Storefront Dropins — provides AI assistants with deep knowledge of blocks, slots, extensions, events, and design tokens",
|
|
5
5
|
"license": "SEE LICENSE IN LICENSE.md",
|
|
6
6
|
"author": "Adobe Commerce Storefront Team",
|
|
7
7
|
"type": "module",
|
|
8
8
|
"bin": {
|
|
9
|
-
"mcp
|
|
9
|
+
"dropins-mcp": "dist/index.js"
|
|
10
10
|
},
|
|
11
11
|
"engines": {
|
|
12
12
|
"node": ">=18.0.0"
|