@cloudinary/asset-management-mcp 0.9.1 → 0.9.3

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 (47) hide show
  1. package/README.md +12 -15
  2. package/bin/mcp-server.js +288 -369
  3. package/bin/mcp-server.js.map +13 -13
  4. package/esm/landing-page.d.ts.map +1 -1
  5. package/esm/landing-page.js +9 -3
  6. package/esm/landing-page.js.map +1 -1
  7. package/esm/lib/config.d.ts +3 -3
  8. package/esm/lib/config.js +3 -3
  9. package/esm/mcp-server/apps/app-shared.d.ts +6 -5
  10. package/esm/mcp-server/apps/app-shared.d.ts.map +1 -1
  11. package/esm/mcp-server/apps/app-shared.js +134 -14
  12. package/esm/mcp-server/apps/app-shared.js.map +1 -1
  13. package/esm/mcp-server/apps/asset-details-app.d.ts.map +1 -1
  14. package/esm/mcp-server/apps/asset-details-app.js +7 -14
  15. package/esm/mcp-server/apps/asset-details-app.js.map +1 -1
  16. package/esm/mcp-server/apps/asset-gallery-app.d.ts.map +1 -1
  17. package/esm/mcp-server/apps/asset-gallery-app.js +99 -306
  18. package/esm/mcp-server/apps/asset-gallery-app.js.map +1 -1
  19. package/esm/mcp-server/apps/asset-upload-app.d.ts.map +1 -1
  20. package/esm/mcp-server/apps/asset-upload-app.js +29 -24
  21. package/esm/mcp-server/apps/asset-upload-app.js.map +1 -1
  22. package/esm/mcp-server/apps/config.d.ts.map +1 -1
  23. package/esm/mcp-server/apps/config.js +1 -2
  24. package/esm/mcp-server/apps/config.js.map +1 -1
  25. package/esm/mcp-server/apps/extensions.d.ts.map +1 -1
  26. package/esm/mcp-server/apps/extensions.js +6 -1
  27. package/esm/mcp-server/apps/extensions.js.map +1 -1
  28. package/esm/mcp-server/cli/serve/impl.js +1 -1
  29. package/esm/mcp-server/cli/serve/impl.js.map +1 -1
  30. package/esm/mcp-server/mcp-server.js +1 -1
  31. package/esm/mcp-server/server.js +1 -1
  32. package/esm/types/bigint.d.ts.map +1 -1
  33. package/esm/types/bigint.js +4 -3
  34. package/esm/types/bigint.js.map +1 -1
  35. package/package.json +1 -1
  36. package/src/landing-page.ts +9 -3
  37. package/src/lib/config.ts +3 -3
  38. package/src/mcp-server/apps/app-shared.ts +135 -14
  39. package/src/mcp-server/apps/asset-details-app.ts +7 -13
  40. package/src/mcp-server/apps/asset-gallery-app.ts +99 -305
  41. package/src/mcp-server/apps/asset-upload-app.ts +29 -23
  42. package/src/mcp-server/apps/config.ts +1 -2
  43. package/src/mcp-server/apps/extensions.ts +6 -1
  44. package/src/mcp-server/cli/serve/impl.ts +1 -1
  45. package/src/mcp-server/mcp-server.ts +1 -1
  46. package/src/mcp-server/server.ts +1 -1
  47. package/src/types/bigint.ts +18 -17
package/README.md CHANGED
@@ -30,9 +30,9 @@
30
30
  <details>
31
31
  <summary>Claude Desktop</summary>
32
32
 
33
- Install the MCP server as a Desktop Extension using the pre-built [`mcp-server.mcpb`](https://github.com/cloudinary/asset-management-mcp/releases/download/v0.9.1/mcp-server.mcpb) file:
33
+ Install the MCP server as a Desktop Extension using the pre-built [`mcp-server.mcpb`](https://github.com/cloudinary/asset-management-mcp/releases/download/v0.9.3/mcp-server.mcpb) file:
34
34
 
35
- Simply drag and drop the [`mcp-server.mcpb`](https://github.com/cloudinary/asset-management-mcp/releases/download/v0.9.1/mcp-server.mcpb) file onto Claude Desktop to install the extension.
35
+ Simply drag and drop the [`mcp-server.mcpb`](https://github.com/cloudinary/asset-management-mcp/releases/download/v0.9.3/mcp-server.mcpb) file onto Claude Desktop to install the extension.
36
36
 
37
37
  The MCP bundle package includes the MCP server and all necessary configuration. Once installed, the server will be available without additional setup.
38
38
 
@@ -174,7 +174,7 @@ The MCP server supports the following environment variables:
174
174
  | `CLOUDINARY_API_SECRET` | Your Cloudinary API secret | Yes |
175
175
  | `CLOUDINARY_URL` | Complete Cloudinary URL (alternative to individual vars) | No |
176
176
  | `CLOUDINARY_COLLECT_HEADERS` | Collect API response headers (see below) | No |
177
- | `CLOUDINARY_MCP_APPS` | Enable MCP Apps (see [MCP Apps](#mcp-apps)) | No |
177
+ | `CLOUDINARY_MCP_APPS` | Override MCP Apps default (see [MCP Apps](#mcp-apps)) | No |
178
178
 
179
179
  ### CLOUDINARY_URL Format
180
180
 
@@ -223,29 +223,26 @@ When enabled, collected headers appear in an `_headers` field in the tool respon
223
223
 
224
224
  The server can expose interactive MCP UI **Apps** (spec-aligned with `io.modelcontextprotocol/ui`) that hosts can render alongside tool results — for example, an asset gallery for list results, a single-asset detail view, and an upload UI.
225
225
 
226
- Apps are **opt-in**. Use the `--mcp-apps` flag (available on both `start` and `serve`) or the `CLOUDINARY_MCP_APPS` environment variable to enable them:
226
+ Apps are **enabled by default**. Use the `--mcp-apps` flag (available on both `start` and `serve`) or the `CLOUDINARY_MCP_APPS` environment variable to override this behaviour:
227
227
 
228
228
  | Value | Effect |
229
229
  |-------|--------|
230
- | bare `--mcp-apps` (no value), `all`, or `true` | Enable every app |
230
+ | unset | Default — **all apps enabled** |
231
+ | bare `--mcp-apps` (no value), `all`, or `true` | Enable every app (same as default) |
231
232
  | `none` or `false` | Disable every app (kill-switch) |
232
233
  | comma-separated subset, e.g. `asset-gallery,asset-details` | Enable only the listed apps |
233
- | unset | Default (currently **off**; may flip on in a future release) |
234
234
 
235
235
  Available app names: `asset-gallery`, `asset-details`, `asset-upload`.
236
236
 
237
237
  ```bash
238
- # Enable all apps via CLI flag (bare flag implies "all")
239
- npx @cloudinary/asset-management-mcp start --mcp-apps
240
-
241
- # Equivalent: explicit value
242
- npx @cloudinary/asset-management-mcp start --mcp-apps all
238
+ # Disable all apps
239
+ npx @cloudinary/asset-management-mcp serve --mcp-apps none
243
240
 
244
- # Enable just the gallery via env var
245
- CLOUDINARY_MCP_APPS=asset-gallery npx @cloudinary/asset-management-mcp start
241
+ # Enable only the gallery
242
+ npx @cloudinary/asset-management-mcp start --mcp-apps asset-gallery
246
243
 
247
- # Explicitly disable
248
- npx @cloudinary/asset-management-mcp serve --mcp-apps none
244
+ # Disable via env var
245
+ CLOUDINARY_MCP_APPS=none npx @cloudinary/asset-management-mcp start
249
246
  ```
250
247
 
251
248
  Precedence: CLI flag > environment variable > built-in default.