@productmaker/mcp 0.1.5 → 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 +21 -0
- package/dist/http.js +561 -147
- package/dist/stdio.js +435 -143
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -41,6 +41,25 @@ Header: `Authorization: Bearer pm_live_...`
|
|
|
41
41
|
| `publish_to_shopify` | Publish a completed task to a Shopify store |
|
|
42
42
|
| `publish_to_meta` | Create a Meta Ads campaign from a task (always created PAUSED) |
|
|
43
43
|
|
|
44
|
+
## Multiple photos per product
|
|
45
|
+
|
|
46
|
+
Creative tools accept an `images` array of **1–5 photos of the same product**. The first entry is the hero; the rest are alternate angles. Don't mix different products in one call — that's a separate task each time.
|
|
47
|
+
|
|
48
|
+
Each entry has **exactly one** of:
|
|
49
|
+
|
|
50
|
+
- `{ "url": "https://..." }` — public HTTPS URL (Shopify CDN, Cloudinary, etc.). Use this whenever the photo is already hosted.
|
|
51
|
+
- `{ "path": "/Users/maria/Desktop/foto.jpg" }` — local filesystem path. The MCP process reads the file from disk and uploads its bytes. `~/` and `%USERPROFILE%` are expanded. **Only works with the local stdio MCP (npm).** The hosted `mcp.productmaker.app` endpoint rejects `path` because Cloud Run has no access to your filesystem.
|
|
52
|
+
|
|
53
|
+
Mixed sources in the same call are fine: `[{ "path": "~/Desktop/hero.jpg" }, { "url": "https://..." }]`.
|
|
54
|
+
|
|
55
|
+
### Breaking change in 0.2.0
|
|
56
|
+
|
|
57
|
+
The `base64` field was removed. MCP JSON-RPC transports truncate large tool arguments (~1 MB) and host-attached chat images never reach the model as raw bytes — base64 in practice never worked. Use `path` (local MCP) or `url` (hosted MCP) instead.
|
|
58
|
+
|
|
59
|
+
## Downloading results
|
|
60
|
+
|
|
61
|
+
`get_task_status` returns short-lived (1 h) `mcp.productmaker.app/assets/...` URLs for every image and video. They stream R2 content through the MCP origin so clients with strict allowlists (claude.ai web, ChatGPT) can fetch them. Markdown image URLs auto-render in every major MCP client; videos are clickable download links.
|
|
62
|
+
|
|
44
63
|
## Environment variables
|
|
45
64
|
|
|
46
65
|
| Var | Default | Required for |
|
|
@@ -48,6 +67,8 @@ Header: `Authorization: Bearer pm_live_...`
|
|
|
48
67
|
| `PM_API_KEY` | — | stdio (required) |
|
|
49
68
|
| `PM_API_URL` | `https://api.productmaker.app` | both |
|
|
50
69
|
| `PORT` | `8080` | http only |
|
|
70
|
+
| `MCP_PROXY_BASE_URL` | `https://mcp.productmaker.app` | http only |
|
|
71
|
+
| `PM_PROXY_SECRET` | — | http only (32+ chars; enables asset proxy) |
|
|
51
72
|
|
|
52
73
|
## Support
|
|
53
74
|
|