@shoppexio/mcp-shoppex 0.1.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 +66 -0
- package/bin/shoppex-mcp-install.mjs +19 -0
- package/package.json +40 -0
package/README.md
ADDED
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# @shoppexio/mcp-shoppex
|
|
2
|
+
|
|
3
|
+
One-shot installer for the full Shoppex MCP surface (commerce + themes).
|
|
4
|
+
|
|
5
|
+
The simplest way to wire Shoppex into Claude Desktop, Claude Code, Cursor, or Windsurf:
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npx @shoppexio/mcp-shoppex install --api-key shx_your_dev_api_key
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
That's it. Restart your MCP client and both Shoppex MCP servers are live.
|
|
12
|
+
|
|
13
|
+
## What it installs
|
|
14
|
+
|
|
15
|
+
- **[@shoppexio/mcp-commerce-server](https://www.npmjs.com/package/@shoppexio/mcp-commerce-server)** — 51 tools for products, orders, customers, coupons, payment links, categories, webhooks, invoices, disputes, licenses, affiliates, subscriptions, tickets, blacklist, analytics.
|
|
16
|
+
- **[@shoppexio/mcp-theme-server](https://www.npmjs.com/package/@shoppexio/mcp-theme-server)** — 21 tools for theme inspection, editing, previews, publishing, rollbacks.
|
|
17
|
+
|
|
18
|
+
## Usage
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
# Install into Claude Desktop (default)
|
|
22
|
+
npx @shoppexio/mcp-shoppex install --api-key shx_...
|
|
23
|
+
|
|
24
|
+
# Install into a different client
|
|
25
|
+
npx @shoppexio/mcp-shoppex install --client cursor --api-key shx_...
|
|
26
|
+
npx @shoppexio/mcp-shoppex install --client windsurf --api-key shx_...
|
|
27
|
+
npx @shoppexio/mcp-shoppex install --client claude-code --api-key shx_...
|
|
28
|
+
|
|
29
|
+
# Use a custom backend (e.g. local dev)
|
|
30
|
+
npx @shoppexio/mcp-shoppex install --api-key shx_... --api-url http://localhost:3002
|
|
31
|
+
|
|
32
|
+
# Check what's installed
|
|
33
|
+
npx @shoppexio/mcp-shoppex status
|
|
34
|
+
|
|
35
|
+
# Remove
|
|
36
|
+
npx @shoppexio/mcp-shoppex uninstall
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Supported clients
|
|
40
|
+
|
|
41
|
+
| Client | Config file |
|
|
42
|
+
|--------|-------------|
|
|
43
|
+
| `claude-desktop` (default) | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) |
|
|
44
|
+
| `claude-code` | `~/.claude.json` |
|
|
45
|
+
| `cursor` | `~/.cursor/mcp.json` |
|
|
46
|
+
| `windsurf` | `~/.codeium/windsurf/mcp_config.json` |
|
|
47
|
+
|
|
48
|
+
## Advanced usage
|
|
49
|
+
|
|
50
|
+
For more control, use the full CLI directly:
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
npm install -g @shoppexio/cli
|
|
54
|
+
shoppex auth login --api-key shx_...
|
|
55
|
+
shoppex mcp install
|
|
56
|
+
shoppex mcp status
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## Docs
|
|
60
|
+
|
|
61
|
+
- [Developer API Reference](https://docs.shoppex.io/api-reference/introduction)
|
|
62
|
+
- [Theme AI Workflows](https://docs.shoppex.io/themes/ai-workflows)
|
|
63
|
+
|
|
64
|
+
## License
|
|
65
|
+
|
|
66
|
+
Proprietary. © Shoppex.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// One-shot installer: delegates to `shoppex mcp install` from @shoppexio/cli.
|
|
3
|
+
// The meta-package's only job is to be the single command users run:
|
|
4
|
+
// npx @shoppexio/mcp-shoppex install --api-key shx_...
|
|
5
|
+
|
|
6
|
+
import { runCli } from '@shoppexio/cli/src/cli.mjs';
|
|
7
|
+
|
|
8
|
+
const argv = process.argv.slice(2);
|
|
9
|
+
|
|
10
|
+
// Default to "mcp install" when no subcommand is given; otherwise pass through.
|
|
11
|
+
const first = argv[0];
|
|
12
|
+
const mcpArgs = first === 'install' || first === 'uninstall' || first === 'status'
|
|
13
|
+
? ['mcp', ...argv]
|
|
14
|
+
: first === 'mcp'
|
|
15
|
+
? argv
|
|
16
|
+
: ['mcp', 'install', ...argv];
|
|
17
|
+
|
|
18
|
+
const exitCode = await runCli(mcpArgs);
|
|
19
|
+
process.exit(exitCode ?? 0);
|
package/package.json
ADDED
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@shoppexio/mcp-shoppex",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Shoppex MCP meta-package — bundles the commerce and theme MCP servers and offers a single CLI install command.",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"repository": {
|
|
7
|
+
"type": "git",
|
|
8
|
+
"url": "git+https://github.com/ShoppexIO/shoppex.git",
|
|
9
|
+
"directory": "packages/mcp-shoppex"
|
|
10
|
+
},
|
|
11
|
+
"homepage": "https://docs.shoppex.io/developer-api",
|
|
12
|
+
"bugs": {
|
|
13
|
+
"url": "https://github.com/ShoppexIO/shoppex/issues"
|
|
14
|
+
},
|
|
15
|
+
"publishConfig": {
|
|
16
|
+
"access": "public"
|
|
17
|
+
},
|
|
18
|
+
"keywords": [
|
|
19
|
+
"shoppex",
|
|
20
|
+
"mcp",
|
|
21
|
+
"meta",
|
|
22
|
+
"bundle",
|
|
23
|
+
"installer"
|
|
24
|
+
],
|
|
25
|
+
"bin": {
|
|
26
|
+
"shoppex-mcp-install": "./bin/shoppex-mcp-install.mjs"
|
|
27
|
+
},
|
|
28
|
+
"files": [
|
|
29
|
+
"bin",
|
|
30
|
+
"README.md"
|
|
31
|
+
],
|
|
32
|
+
"engines": {
|
|
33
|
+
"node": ">=18.0.0"
|
|
34
|
+
},
|
|
35
|
+
"dependencies": {
|
|
36
|
+
"@shoppexio/cli": "^0.2.0",
|
|
37
|
+
"@shoppexio/mcp-commerce-server": "^0.6.0",
|
|
38
|
+
"@shoppexio/mcp-theme-server": "^0.3.0"
|
|
39
|
+
}
|
|
40
|
+
}
|