@cloudinary/environment-config-mcp 0.6.1 → 0.6.3

package/src/mcp-server/resources.ts

@@ -3,27 +3,23 @@
  * @generated-id: cb0c57ebeaea
  */
 
+import type { ResourceTemplate as LegacyResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import {
   McpServer,
+  ReadResourceResult,
   ResourceMetadata,
   ResourceTemplate,
-} from "@modelcontextprotocol/sdk/server/mcp.js";
-import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
-import { Variables } from "@modelcontextprotocol/sdk/shared/uriTemplate.js";
-import {
-  ReadResourceResult,
-  ServerNotification,
-  ServerRequest,
-} from "@modelcontextprotocol/sdk/types.js";
+  Variables,
+} from "@modelcontextprotocol/server";
 import { CloudinaryEnvConfigCore } from "../core.js";
 import { ConsoleLogger } from "./console-logger.js";
 import { MCPScope } from "./scopes.js";
-import { valueToBase64 } from "./shared.js";
+import { MCPServerContext, mcpServerContext, valueToBase64 } from "./shared.js";
 
 export type ReadResourceCallback = (
   client: CloudinaryEnvConfigCore,
   uri: URL,
-  extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
+  extra: MCPServerContext,
 ) => ReadResourceResult | Promise<ReadResourceResult>;
 
 export type ResourceDefinition = {
@@ -39,7 +35,7 @@ export type ReadResourceTemplateCallback = (
   client: CloudinaryEnvConfigCore,
   uri: URL,
   vars: Variables,
-  extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
+  extra: MCPServerContext,
 ) => ReadResourceResult | Promise<ReadResourceResult>;
 
 export type ResourceTemplateDefinition = {
@@ -47,7 +43,7 @@ export type ResourceTemplateDefinition = {
   description: string;
   metadata?: ResourceMetadata;
   scopes?: MCPScope[];
-  resource: ResourceTemplate;
+  resource: ResourceTemplate | LegacyResourceTemplate;
   read: ReadResourceTemplateCallback;
 };
 
@@ -95,11 +91,11 @@ export function createRegisterResource(
       description: resource.description,
     };
 
-    server.resource(
+    server.registerResource(
       resource.name,
       resource.resource,
       metadata,
-      async (uri, ctx) => resource.read(getSDK(), uri, ctx),
+      async (uri, ctx) => resource.read(getSDK(), uri, mcpServerContext(ctx)),
     );
 
     logger.debug("Registered resource", { name: resource.name });
@@ -130,13 +126,32 @@ export function createRegisterResourceTemplate(
       description: resource.description,
     };
 
-    server.resource(
+    server.registerResource(
       resource.name,
-      resource.resource,
+      normalizeResourceTemplate(resource.resource),
       metadata,
-      async (uri, vars, ctx) => resource.read(getSDK(), uri, vars, ctx),
+      async (uri, vars, ctx) =>
+        resource.read(getSDK(), uri, vars, mcpServerContext(ctx)),
     );
 
     logger.debug("Registered resource template", { name: resource.name });
   };
 }
+
+function normalizeResourceTemplate(
+  resource: ResourceTemplate | LegacyResourceTemplate,
+): ResourceTemplate {
+  if (resource instanceof ResourceTemplate) return resource;
+  const complete: NonNullable<
+    ConstructorParameters<typeof ResourceTemplate>[1]["complete"]
+  > = {};
+  for (const variable of resource.uriTemplate.variableNames) {
+    const callback = resource.completeCallback(variable);
+    if (callback) complete[variable] = callback;
+  }
+  const list = resource.listCallback;
+  return new ResourceTemplate(resource.uriTemplate.toString(), {
+    list: list ? (ctx) => list(mcpServerContext(ctx)) : undefined,
+    complete,
+  });
+}

package/src/mcp-server/server-info.ts

@@ -0,0 +1,31 @@
+/*
+ * Server metadata and instructions returned in the MCP initialize response.
+ */
+
+import type { Implementation } from "@modelcontextprotocol/sdk/types.js";
+
+const ICON_BASE =
+  "https://cloudinary-res.cloudinary.com/image/upload/docsite/brand-assets";
+
+export const serverInfo: Omit<Implementation, "name" | "version"> = {
+  title: "Cloudinary Environment Config",
+  description:
+    "Manage Cloudinary upload presets, named transformations, upload mappings, triggers, and streaming profiles.",
+  websiteUrl: "https://cloudinary.com/documentation/cloudinary_llm_mcp",
+  icons: [32, 96, 192].map((size) => ({
+    src: `${ICON_BASE}/cloudinary_favicon_${size}x${size}.png`,
+    mimeType: "image/png",
+    sizes: [`${size}x${size}`],
+  })),
+};
+
+export const instructions =
+  `Cloudinary Environment Config: manage the settings that shape how assets are uploaded, transformed and delivered in a Cloudinary product environment.
+
+- Upload presets bundle upload options (folder, tags, eager and incoming transformations, notification_url) under a name that uploads and the Upload Widget refer to. Check list-upload-presets first: creating a preset with an existing name overwrites it.
+- Named transformations are reusable transformation strings applied in delivery URLs as t_<name>. Changing one requires unsafe_update and affects only newly generated derived assets. Chain f_auto outside it, e.g. t_square/f_auto.
+- Upload mappings link a folder to a remote URL prefix for auto-upload. To apply a preset to a mapping, give the preset the same name as the mapped folder.
+- Triggers send webhook notifications for one event type to one URL. update-trigger, delete-trigger and test-trigger need the id from list-triggers or create-trigger. A preset's notification_url overrides global triggers for uploads that use it.
+- Streaming profiles define adaptive bitrate renditions. Updating one replaces its whole representations list; deleting a modified built-in profile reverts it.
+- Works with the Asset Management server: its upload-asset takes upload_preset.
+- Docs: https://cloudinary.com/documentation/llms.txt indexes all Cloudinary docs; append .md to a documentation URL for Markdown.`;

package/src/mcp-server/server.ts

@@ -3,7 +3,7 @@
  * @generated-id: 2784dd48e82a
  */
 
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer } from "@modelcontextprotocol/server";
 import { CloudinaryEnvConfigCore } from "../core.js";
 import { SDKOptions } from "../lib/config.js";
 import type { ConsoleLogger } from "./console-logger.js";
@@ -13,6 +13,7 @@ import {
   createRegisterResourceTemplate,
 } from "./resources.js";
 import { MCPScope } from "./scopes.js";
+import { instructions, serverInfo } from "./server-info.js";
 import {
   createRegisterTool,
   MCPToolAnnotationFilter,
@@ -59,8 +60,9 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "CloudinaryEnvConfig",
-    version: "0.6.1",
-  });
+    version: "0.6.3",
+    ...serverInfo,
+  }, { instructions });
 
   const getClient = deps.getSDK || (() =>
     new CloudinaryEnvConfigCore({

package/src/mcp-server/shared.ts

@@ -3,8 +3,209 @@
  * @generated-id: 074e80d4be1e
  */
 
+import type { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import type {
+  ServerNotification,
+  ServerRequest,
+} from "@modelcontextprotocol/sdk/types.js";
+import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
+import type {
+  ServerContext,
+  StandardSchemaWithJSON,
+} from "@modelcontextprotocol/server";
 import * as z from "zod";
 
+export type MCPServerContext =
+  & ServerContext
+  & RequestHandlerExtra<ServerRequest, ServerNotification>;
+
+export function mcpServerContext(ctx: ServerContext): MCPServerContext {
+  return {
+    ...ctx,
+    signal: ctx.mcpReq.signal,
+    requestId: ctx.mcpReq.id,
+    ...(ctx.mcpReq._meta ? { _meta: ctx.mcpReq._meta } : {}),
+    ...(ctx.http?.authInfo ? { authInfo: ctx.http.authInfo } : {}),
+    ...(ctx.http?.req
+      ? {
+        requestInfo: {
+          headers: Object.fromEntries(ctx.http.req.headers),
+          url: new URL(ctx.http.req.url),
+        },
+      }
+      : {}),
+    ...(ctx.http?.closeSSE ? { closeSSEStream: ctx.http.closeSSE } : {}),
+    ...(ctx.http?.closeStandaloneSSE
+      ? { closeStandaloneSSEStream: ctx.http.closeStandaloneSSE }
+      : {}),
+    sendNotification: async (notification) => {
+      if (!ctx.mcpReq.signal.aborted) await ctx.mcpReq.notify(notification);
+    },
+    sendRequest: async (request, resultSchema, options) => {
+      if (ctx.mcpReq.signal.aborted) {
+        throw new McpError(ErrorCode.ConnectionClosed, "Request was cancelled");
+      }
+      return (ctx.mcpReq.send as MCPServerContext["sendRequest"])(
+        request,
+        resultSchema,
+        options,
+      );
+    },
+  };
+}
+
+export function mcpInputSchema<Shape extends z.ZodRawShape>(
+  shape: Shape,
+): StandardSchemaWithJSON<
+  z.input<z.ZodObject<Shape>>,
+  z.output<z.ZodObject<Shape>>
+> {
+  const schema = z.object(shape);
+  const standard = schema["~standard"];
+  return {
+    "~standard": {
+      ...standard,
+      jsonSchema: {
+        input: (options) => {
+          const source = jsonSchemaSource(schema);
+          return source.schema["~standard"].jsonSchema.input({
+            ...options,
+            libraryOptions: {
+              ...options.libraryOptions,
+              metadata: source.metadata,
+              override: source.override,
+              unrepresentable: "any",
+            },
+          });
+        },
+        output: (options) => {
+          const source = jsonSchemaSource(schema);
+          return source.schema["~standard"].jsonSchema.output({
+            ...options,
+            libraryOptions: {
+              ...options.libraryOptions,
+              metadata: source.metadata,
+              override: source.override,
+              unrepresentable: "any",
+            },
+          });
+        },
+      },
+    },
+  };
+}
+
+// Zod serializes defaults before its override runs; clone only the conversion schema to preserve runtime defaults.
+function jsonSchemaSource(schema: z.ZodType) {
+  const registry = z.registry<z.core.GlobalMeta>();
+  const copies = new WeakMap<object, unknown>();
+  const defaults = new WeakMap<z.core.$ZodType, unknown>();
+  const jsonValue = (value: unknown, onNormalized?: () => void): unknown =>
+    value === undefined ? undefined : JSON.parse(
+      JSON.stringify(
+        value,
+        function(this: Record<string, unknown>, key, item: unknown) {
+          if (this[key] instanceof Date) onNormalized?.();
+          if (typeof item !== "bigint") return item;
+          onNormalized?.();
+          return item.toString();
+        },
+      ),
+    );
+  const copy = (value: unknown): unknown => {
+    if (typeof value !== "object" || value === null) return value;
+    if (copies.has(value)) return copies.get(value);
+    if (value instanceof z.ZodType) {
+      const def = copy(value.def) as z.ZodType["def"];
+      const cloned = value.clone(def);
+      copies.set(value, cloned);
+      const metadata = value.meta();
+      if (metadata) {
+        registry.add(cloned, jsonValue(metadata) as typeof metadata);
+      }
+      if (value instanceof z.ZodDefault || value instanceof z.ZodPrefault) {
+        let hasNormalizedDefault = false;
+        const normalized = jsonValue(value.def.defaultValue, () => {
+          hasNormalizedDefault = true;
+        });
+        if (hasNormalizedDefault) {
+          defaults.set(cloned, undefined);
+          try {
+            if (z.safeParse(value.def.innerType, normalized).success) {
+              defaults.set(cloned, normalized);
+            }
+          } catch {
+            return cloned;
+          }
+        }
+      }
+      if (value instanceof z.ZodCatch) {
+        (def as z.ZodCatch["def"]).catchValue = (ctx) => {
+          let fallback: unknown;
+          try {
+            fallback = value.def.catchValue(ctx);
+          } catch (error) {
+            if (ctx !== undefined) throw error;
+            defaults.set(cloned, undefined);
+            return undefined;
+          }
+          let hasNormalizedDefault = false;
+          const normalized = jsonValue(fallback, () => {
+            hasNormalizedDefault = true;
+          });
+          if (hasNormalizedDefault) {
+            defaults.set(cloned, undefined);
+            try {
+              if (z.safeParse(value.def.innerType, normalized).success) {
+                defaults.set(cloned, normalized);
+              }
+            } catch {
+              return normalized;
+            }
+          }
+          return normalized;
+        };
+      }
+      return cloned;
+    }
+    if (Array.isArray(value)) {
+      const cloned: unknown[] = [];
+      copies.set(value, cloned);
+      for (const item of value) cloned.push(copy(item));
+      return cloned;
+    }
+    if (Object.getPrototypeOf(value) !== Object.prototype) return value;
+    const cloned: Record<string, unknown> = {};
+    copies.set(value, cloned);
+    for (const key of Object.keys(value)) {
+      const descriptor = Object.getOwnPropertyDescriptor(value, key)!;
+      const read = () => {
+        const item: unknown = Reflect.get(value, key);
+        if (key === "defaultValue") return jsonValue(item);
+        if (key === "getter" && typeof item === "function") {
+          return () => copy(item());
+        }
+        return copy(item);
+      };
+      if (descriptor.get) {
+        Object.defineProperty(cloned, key, { enumerable: true, get: read });
+      } else {
+        cloned[key] = read();
+      }
+    }
+    return cloned;
+  };
+  const override: NonNullable<z.core.ToJSONSchemaParams["override"]> = (
+    { zodSchema, jsonSchema },
+  ) => {
+    if (!defaults.has(zodSchema)) return;
+    const value = defaults.get(zodSchema);
+    if (value === undefined) delete jsonSchema.default;
+    else jsonSchema.default = value;
+  };
+  return { schema: copy(schema) as z.ZodType, metadata: registry, override };
+}
+
 type BinaryData =
   | Uint8Array
   | ArrayBuffer

package/src/mcp-server/tools/streamingProfilesCreateStreamingProfile.ts

@@ -32,7 +32,7 @@ export const tool$streamingProfilesCreateStreamingProfile: ToolDefinition<
     const [result] = await streamingProfilesCreateStreamingProfile(
       client,
       args.request,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/streamingProfilesDeleteStreamingProfile.ts

@@ -30,7 +30,7 @@ export const tool$streamingProfilesDeleteStreamingProfile: ToolDefinition<
     const [result] = await streamingProfilesDeleteStreamingProfile(
       client,
       args.name,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/streamingProfilesGetStreamingProfile.ts

@@ -30,7 +30,7 @@ export const tool$streamingProfilesGetStreamingProfile: ToolDefinition<
     const [result] = await streamingProfilesGetStreamingProfile(
       client,
       args.name,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/streamingProfilesGetStreamingProfiles.ts

@@ -30,7 +30,7 @@ export const tool$streamingProfilesGetStreamingProfiles: ToolDefinition<
     const [result] = await streamingProfilesGetStreamingProfiles(
       client,
       args.request,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/streamingProfilesUpdateStreamingProfile.ts

@@ -35,7 +35,7 @@ export const tool$streamingProfilesUpdateStreamingProfile: ToolDefinition<
       client,
       args.name,
       args.streaming_profile_update,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/transformationsCreateTransformation.ts

@@ -40,7 +40,7 @@ Creates a new named transformation with the given name and transformation string
       client,
       args.transformation,
       args.create_request,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/transformationsDeleteTransformation.ts

@@ -38,7 +38,7 @@ Delete a named or unnamed transformation. Optionally invalidate derived resource
       client,
       args.transformation,
       args.invalidate,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/transformationsGetTransformation.ts

@@ -34,7 +34,7 @@ Retrieves details for a named or unnamed transformation.
     const [result] = await transformationsGetTransformation(
       client,
       args.transformation,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/transformationsListTransformations.ts

@@ -43,7 +43,7 @@ Retrieves a list of all transformations, which can be filtered to show either on
       args.named,
       args.max_results,
       args.next_cursor,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/transformationsUpdateTransformation.ts

@@ -39,7 +39,7 @@ Updates a named or unnamed transformation.
       client,
       args.transformation,
       args.update_request,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/triggersCreateTrigger.ts

@@ -34,7 +34,7 @@ Your product environment supports triggers up to a maximum determined by multipl
     const [result] = await triggersCreateTrigger(
       client,
       args.request,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/triggersDeleteTrigger.ts

@@ -29,7 +29,7 @@ Deletes a trigger.`,
     const [result] = await triggersDeleteTrigger(
       client,
       args.id,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/triggersListTrigger.ts

@@ -33,7 +33,7 @@ Retrieves a list of all event triggers and notifications within your product env
     const [result] = await triggersListTrigger(
       client,
       args.event_type,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/triggersTestTrigger.ts

@@ -36,7 +36,7 @@ Use this endpoint to verify that a trigger's filter will match expected events.
       client,
       args.id,
       args.test_trigger_request,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/triggersUpdateTrigger.ts

@@ -35,7 +35,7 @@ Updates a notification URL for a trigger.`,
       client,
       args.id,
       args.update_trigger_request,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/uploadMappingsCreateUploadMapping.ts

@@ -33,7 +33,7 @@ Creates a new upload mapping for the specified folder`,
     const [result] = await uploadMappingsCreateUploadMapping(
       client,
       args.request,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/uploadMappingsDeleteUploadMapping.ts

@@ -31,7 +31,7 @@ Permanently deletes the upload mapping for the specified folder`,
     const [result] = await uploadMappingsDeleteUploadMapping(
       client,
       args.folder,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/uploadMappingsListUploadMappings.ts

@@ -44,7 +44,7 @@ Upload mappings allow you to map an upload preset to a specific folder and URL t
       args.folder,
       args.next_cursor,
       args.max_results,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/uploadMappingsUpdateUploadMapping.ts

@@ -34,7 +34,7 @@ Updates the URL template for an existing folder mapping`,
     const [result] = await uploadMappingsUpdateUploadMapping(
       client,
       args.request,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/uploadPresetsCreateUploadPreset.ts

@@ -31,7 +31,7 @@ export const tool$uploadPresetsCreateUploadPreset: ToolDefinition<typeof args> =
       const [result] = await uploadPresetsCreateUploadPreset(
         client,
         args.request,
-        { fetchOptions: { signal: ctx.signal } },
+        { fetchOptions: { signal: ctx.mcpReq.signal } },
       ).$inspect();
 
       if (!result.ok) {

package/src/mcp-server/tools/uploadPresetsDeleteUploadPreset.ts

@@ -28,7 +28,7 @@ export const tool$uploadPresetsDeleteUploadPreset: ToolDefinition<typeof args> =
       const [result] = await uploadPresetsDeleteUploadPreset(
         client,
         args.name,
-        { fetchOptions: { signal: ctx.signal } },
+        { fetchOptions: { signal: ctx.mcpReq.signal } },
       ).$inspect();
 
       if (!result.ok) {

package/src/mcp-server/tools/uploadPresetsGetUploadPreset.ts

@@ -27,7 +27,7 @@ export const tool$uploadPresetsGetUploadPreset: ToolDefinition<typeof args> = {
     const [result] = await uploadPresetsGetUploadPreset(
       client,
       args.name,
-      { fetchOptions: { signal: ctx.signal } },
+      { fetchOptions: { signal: ctx.mcpReq.signal } },
     ).$inspect();
 
     if (!result.ok) {

package/src/mcp-server/tools/uploadPresetsListUploadPresets.ts

@@ -44,7 +44,7 @@ export const tool$uploadPresetsListUploadPresets: ToolDefinition<typeof args> =
         args.direction,
         args.max_results,
         args.next_cursor,
-        { fetchOptions: { signal: ctx.signal } },
+        { fetchOptions: { signal: ctx.mcpReq.signal } },
       ).$inspect();
 
       if (!result.ok) {

package/src/mcp-server/tools/uploadPresetsUpdateUploadPreset.ts

@@ -33,7 +33,7 @@ export const tool$uploadPresetsUpdateUploadPreset: ToolDefinition<typeof args> =
         client,
         args.name,
         args.upload_preset_input,
-        { fetchOptions: { signal: ctx.signal } },
+        { fetchOptions: { signal: ctx.mcpReq.signal } },
       ).$inspect();
 
       if (!result.ok) {