@cloudinary/asset-management-mcp 0.7.0 → 0.8.0

package/src/funcs/videoAnalyticsGetVideoViews.ts

@@ -21,7 +21,7 @@ import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
 import {
   GetVideoViewsRequest,
   GetVideoViewsRequest$zodSchema,
-  SortBy,
+  GetVideoViewsSortBy,
 } from "../models/getvideoviewsop.js";
 import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
@@ -37,7 +37,7 @@ export function videoAnalyticsGetVideoViews(
   client$: CloudinaryAssetMgmtCore,
   expression?: string | undefined,
   max_results?: number | undefined,
-  sort_by?: SortBy | undefined,
+  sort_by?: GetVideoViewsSortBy | undefined,
   next_cursor?: string | undefined,
   options?: RequestOptions,
 ): APIPromise<
@@ -66,7 +66,7 @@ async function $do(
   client$: CloudinaryAssetMgmtCore,
   expression?: string | undefined,
   max_results?: number | undefined,
-  sort_by?: SortBy | undefined,
+  sort_by?: GetVideoViewsSortBy | undefined,
   next_cursor?: string | undefined,
   options?: RequestOptions,
 ): Promise<

package/src/landing-page.ts

@@ -932,7 +932,7 @@ http_headers = { "api-key" = "YOUR_API_KEY", "api-secret" = "YOUR_API_SECRET", "
         <h1>Instructions</h1>
         <p>One-click installation for Claude Desktop users</p>
         <div class="instruction-item">
-          <a href="https://github.com/cloudinary/asset-management-mcp/releases/download/v0.7.0/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
+          <a href="https://github.com/cloudinary/asset-management-mcp/releases/download/v0.8.0/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
             📥 Download MCP Bundle
           </a>
         </div>

package/src/lib/config.ts

@@ -111,9 +111,9 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 
 export const SDK_METADATA = {
   language: "typescript",
-  openapiDocVersion: "0.3.5",
-  sdkVersion: "0.7.0",
-  genVersion: "2.824.1",
+  openapiDocVersion: "0.4.0",
+  sdkVersion: "0.8.0",
+  genVersion: "2.865.2",
   userAgent:
-    "speakeasy-sdk/mcp-typescript 0.7.0 2.824.1 0.3.5 @cloudinary/asset-management-mcp",
+    "speakeasy-sdk/mcp-typescript 0.8.0 2.865.2 0.4.0 @cloudinary/asset-management-mcp",
 } as const;

package/src/lib/security.ts

@@ -84,7 +84,10 @@ type SecurityInputOAuth2 = {
 type SecurityInputOAuth2ClientCredentials = {
   type: "oauth2:client_credentials";
   value:
-    | { clientID?: string | undefined; clientSecret?: string | undefined }
+    | {
+      clientID?: string | undefined;
+      clientSecret?: string | undefined;
+    }
     | null
     | string
     | undefined;

package/src/mcp-server/cli/serve/command.ts

@@ -0,0 +1,147 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { buildCommand } from "@stricli/core";
+import { numberParser } from "@stricli/core";
+import * as z from "zod";
+import { ServerRegion } from "../../../lib/config.js";
+import { consoleLoggerLevels } from "../../console-logger.js";
+import { mcpScopes } from "../../scopes.js";
+
+export const serveCommand = buildCommand({
+  loader: async () => {
+    const { main } = await import("./impl.js");
+    return main;
+  },
+  parameters: {
+    flags: {
+      port: {
+        kind: "parsed",
+        brief: "The port to listen on for Streamable HTTP connections",
+        default: "2718",
+        parse: (val: string) =>
+          z.coerce.number().int().gte(0).lt(65536).parse(val),
+      },
+      "disable-static-auth": {
+        kind: "boolean",
+        brief:
+          "Disable static authentication, allowing credentials to be passed via request headers only",
+        default: false,
+      },
+      tool: {
+        kind: "parsed",
+        brief: "Specify tools to mount on the server",
+        optional: true,
+        variadic: true,
+        parse: (value) => {
+          return z.string().parse(value);
+        },
+      },
+      mode: {
+        kind: "enum",
+        brief:
+          "Server mode (dynamic: expose list_tools, describe_tool, and execute_tool instead of individual tools)",
+        values: ["dynamic"],
+        optional: true,
+      },
+      scope: {
+        kind: "enum",
+        brief: "Mount tools/resources that match given scope (repeatable flag)",
+        values: mcpScopes,
+        variadic: true,
+        optional: true,
+      },
+      "api-key": {
+        kind: "parsed",
+        brief: "Sets the api_key auth field for the API",
+        optional: true,
+        parse: (value) => {
+          return z.string().parse(value);
+        },
+      },
+      "api-secret": {
+        kind: "parsed",
+        brief: "Sets the api_secret auth field for the API",
+        optional: true,
+        parse: (value) => {
+          return z.string().parse(value);
+        },
+      },
+      oauth2: {
+        kind: "parsed",
+        brief: "Sets the oauth2 auth field for the API",
+        optional: true,
+        parse: (value) => {
+          return z.string().parse(value);
+        },
+      },
+      "cloud-name": {
+        kind: "parsed",
+        brief:
+          "Allows setting the cloud_name parameter for all supported operations",
+        optional: true,
+        parse: (value) => {
+          return z.string().parse(value);
+        },
+      },
+      "server-url": {
+        kind: "parsed",
+        brief: "Overrides the default server URL used by the SDK",
+        optional: true,
+        parse: (value) => new URL(value).toString(),
+      },
+      "server-index": {
+        kind: "parsed",
+        brief: "Selects a predefined server used by the SDK",
+        optional: true,
+        parse: numberParser,
+      },
+      region: {
+        kind: "enum",
+        brief: "Sets the region variable for url substitution",
+        optional: true,
+        values: Object.values(ServerRegion) as Array<ServerRegion>,
+      },
+      "api-host": {
+        kind: "parsed",
+        brief: "Sets the host variable for url substitution",
+        optional: true,
+        parse: (value) => value,
+      },
+      "log-level": {
+        kind: "enum",
+        brief: "The log level to use for the server",
+        default: "info",
+        values: consoleLoggerLevels,
+      },
+      env: {
+        kind: "parsed",
+        brief: "Environment variables made available to the server",
+        optional: true,
+        variadic: true,
+        parse: (val: string) => {
+          const sepIdx = val.indexOf("=");
+          if (sepIdx === -1) {
+            throw new Error("Invalid environment variable format");
+          }
+
+          const key = val.slice(0, sepIdx);
+          const value = val.slice(sepIdx + 1);
+
+          return [
+            z.string().nonempty({
+              message: "Environment variable key must be a non-empty string",
+            }).parse(key),
+            z.string().nonempty({
+              message: "Environment variable value must be a non-empty string",
+            }).parse(value),
+          ] satisfies [string, string];
+        },
+      },
+    },
+  },
+  docs: {
+    brief: "Run the MCP server with Streamable HTTP transport",
+  },
+});

package/src/mcp-server/cli/serve/impl.ts

@@ -0,0 +1,114 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import express from "express";
+import { LocalContext } from "../../cli.js";
+import {
+  ConsoleLoggerLevel,
+  createConsoleLogger,
+} from "../../console-logger.js";
+import { MCPServerFlags } from "../../flags.js";
+import { createMCPServer } from "../../server.js";
+import { buildSDK } from "../../tools.js";
+
+import { landingPageExpress } from "../../../landing-page.js";
+
+interface ServeCommandFlags extends MCPServerFlags {
+  readonly port: number;
+  readonly "disable-static-auth": boolean;
+  readonly "log-level": ConsoleLoggerLevel;
+  readonly env?: [string, string][];
+}
+
+export async function main(this: LocalContext, flags: ServeCommandFlags) {
+  flags.env?.forEach(([key, value]) => {
+    process.env[key] = value;
+  });
+
+  await startStreamableHTTP(flags);
+}
+
+async function startStreamableHTTP(cliFlags: ServeCommandFlags) {
+  const logger = createConsoleLogger(cliFlags["log-level"]);
+  const app = express();
+
+  // Enable CORS for cross-origin requests
+  app.use((req, res, next) => {
+    res.header("Access-Control-Allow-Origin", "*");
+    res.header("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+    res.header("Access-Control-Allow-Headers", "Content-Type, *");
+    if (req.method === "OPTIONS") {
+      res.sendStatus(204);
+      return;
+    }
+    next();
+  });
+
+  app.use(express.json());
+
+  app.post("/mcp", async (req, res) => {
+    const headers = new Headers();
+    for (const [key, value] of Object.entries(req.headers)) {
+      if (Array.isArray(value)) {
+        for (const v of value) headers.append(key, v);
+      } else if (value !== undefined) {
+        headers.set(key, value);
+      }
+    }
+
+    const transport = new StreamableHTTPServerTransport({});
+
+    const { server: mcpServer } = createMCPServer({
+      logger,
+      allowedTools: cliFlags.tool,
+      dynamic: cliFlags.mode === "dynamic",
+      scopes: cliFlags.scope,
+      serverURL: cliFlags["server-url"],
+      getSDK: () =>
+        buildSDK(headers, cliFlags, cliFlags["disable-static-auth"], logger),
+      cloud_name: cliFlags["cloud-name"],
+      serverIdx: cliFlags["server-index"],
+      region: cliFlags.region,
+      host: cliFlags["api-host"],
+    });
+
+    mcpServer.server.onerror = (error) => {
+      logger.error("MCP protocol error", {
+        error: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : undefined,
+      });
+    };
+
+    await mcpServer.connect(transport as Transport);
+    await transport.handleRequest(req, res, req.body);
+  });
+
+  app.get("/", landingPageExpress);
+
+  const httpServer = app.listen(cliFlags.port, "0.0.0.0", () => {
+    const ha = httpServer.address();
+    const host = typeof ha === "string" ? ha : `${ha?.address}:${ha?.port}`;
+    logger.info("MCP Streamable HTTP server started", { host });
+  });
+
+  const shutdown = () => {
+    logger.info("Shutting down HTTP server");
+
+    const timer = setTimeout(() => {
+      logger.info("Forcing shutdown");
+      process.exit(1);
+    }, 5000);
+
+    httpServer.close(() => {
+      clearTimeout(timer);
+      logger.info("Graceful shutdown complete");
+      process.exit(0);
+    });
+  };
+
+  process.on("SIGTERM", shutdown);
+  process.on("SIGINT", shutdown);
+}

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

@@ -5,11 +5,13 @@
 import { buildApplication, buildRouteMap, run } from "@stricli/core";
 import process from "node:process";
 import { buildContext } from "./cli.js";
+import { serveCommand } from "./cli/serve/command.js";
 import { startCommand } from "./cli/start/command.js";
 
 const routes = buildRouteMap({
   routes: {
     start: startCommand,
+    serve: serveCommand,
   },
   docs: {
     brief: "MCP server CLI",
@@ -19,7 +21,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.7.0",
+    currentVersion: "0.8.0",
   },
 });
 

package/src/mcp-server/server.ts

@@ -52,7 +52,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "CloudinaryAssetMgmt",
-    version: "0.7.0",
+    version: "0.8.0",
   });
 
   const getClient = deps.getSDK || (() =>

package/src/mcp-server/tools.ts

@@ -15,7 +15,9 @@ import {
 } from "@modelcontextprotocol/sdk/types.js";
 import * as z from "zod";
 import { CloudinaryAssetMgmtCore } from "../core.js";
+import { ServerRegion$zodSchema } from "../lib/config.js";
 import { ConsoleLogger } from "./console-logger.js";
+import { MCPServerFlags } from "./flags.js";
 import { MCPScope, mcpScopes } from "./scopes.js";
 import { valueToBase64 } from "./shared.js";
 
@@ -376,3 +378,90 @@ export function registerDynamicTools(
     logger.debug("Registered dynamic meta-tool", { name: "list_scopes" });
   }
 }
+function resolveHeader<T>(
+  headers: Headers,
+  headerName: string,
+  schema: z.ZodType<T>,
+  cliFlagValue: T | undefined,
+  disableStaticAuth: boolean,
+): T | undefined {
+  const val = headers.get(headerName);
+  if (val != null) {
+    return schema.parse(val);
+  }
+  return disableStaticAuth ? undefined : schema.parse(cliFlagValue);
+}
+
+export function buildSDK(
+  headers: Headers,
+  cliFlags: MCPServerFlags,
+  disableStaticAuth: boolean,
+  logger: { level: string },
+) {
+  const flags = {
+    ...cliFlags,
+    "api-key": resolveHeader(
+      headers,
+      "api-key",
+      z.string(),
+      cliFlags["api-key"],
+      disableStaticAuth,
+    ),
+    "api-secret": resolveHeader(
+      headers,
+      "api-secret",
+      z.string(),
+      cliFlags["api-secret"],
+      disableStaticAuth,
+    ),
+    "oauth2": resolveHeader(
+      headers,
+      "oauth2",
+      z.string(),
+      cliFlags["oauth2"],
+      disableStaticAuth,
+    ),
+  };
+
+  return new CloudinaryAssetMgmtCore({
+    security: {
+      cloudinaryAuth: flags["api-key"] != null && flags["api-secret"] != null
+        ? {
+          api_key: flags["api-key"] ?? "",
+          api_secret: flags["api-secret"] ?? "",
+        }
+        : void 0,
+      oauth2: flags.oauth2 ?? "",
+    },
+    serverURL: cliFlags["server-url"],
+    cloud_name: resolveHeader(
+      headers,
+      "cloud-name",
+      z.string(),
+      cliFlags["cloud-name"],
+      disableStaticAuth,
+    ),
+    serverIdx: cliFlags["server-index"],
+    region: resolveHeader(
+      headers,
+      "region",
+      ServerRegion$zodSchema,
+      cliFlags.region,
+      disableStaticAuth,
+    ),
+    host: resolveHeader(
+      headers,
+      "api-host",
+      z.string(),
+      cliFlags["api-host"],
+      disableStaticAuth,
+    ),
+    debugLogger: logger.level === "debug"
+      ? {
+        log: (...args) => console.log(...args),
+        group: (...args) => console.group(...args),
+        groupEnd: (...args) => console.groupEnd(...args),
+      }
+      : undefined,
+  });
+}

package/src/models/assignfolderrolesop.ts

@@ -0,0 +1,46 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ApiError, ApiError$zodSchema } from "./apierror.js";
+import {
+  AssignFolderRolesRequest,
+  AssignFolderRolesRequest$zodSchema,
+} from "./assignfolderrolesrequest.js";
+import {
+  SuccessResponse,
+  SuccessResponse$zodSchema,
+} from "./successresponse.js";
+
+export type AssignFolderRolesGlobals = { cloud_name?: string | undefined };
+
+export const AssignFolderRolesGlobals$zodSchema: z.ZodType<
+  AssignFolderRolesGlobals
+> = z.object({
+  cloud_name: z.string().describe("The cloud name of your product environment.")
+    .optional(),
+});
+
+export type AssignFolderRolesRequestRequest = {
+  folder_id: string;
+  assign_folder_roles_request: AssignFolderRolesRequest;
+};
+
+export const AssignFolderRolesRequestRequest$zodSchema: z.ZodType<
+  AssignFolderRolesRequestRequest
+> = z.object({
+  assign_folder_roles_request: AssignFolderRolesRequest$zodSchema,
+  folder_id: z.string().describe(
+    "The immutable identifier of the folder, returned by the Get root folders and Get subfolders endpoints.",
+  ),
+});
+
+export type AssignFolderRolesResponse = SuccessResponse | ApiError;
+
+export const AssignFolderRolesResponse$zodSchema: z.ZodType<
+  AssignFolderRolesResponse
+> = z.union([
+  SuccessResponse$zodSchema,
+  ApiError$zodSchema,
+]);

package/src/models/assignfolderrolesrequest.ts

@@ -0,0 +1,52 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+import { PrincipalType, PrincipalType$zodSchema } from "./principaltype.js";
+
+/**
+ * The user, group, or API key whose role assignments are being modified.
+ */
+export type Principal = { type: PrincipalType; id: string };
+
+export const Principal$zodSchema: z.ZodType<Principal> = z.object({
+  id: z.string(),
+  type: PrincipalType$zodSchema,
+}).describe(
+  "The user, group, or API key whose role assignments are being modified.",
+);
+
+/**
+ * The operation to perform on the principal’s role assignments. `add` grants the specified roles; `remove` revokes them.
+ */
+export const Operation = {
+  Add: "add",
+  Remove: "remove",
+} as const;
+/**
+ * The operation to perform on the principal’s role assignments. `add` grants the specified roles; `remove` revokes them.
+ */
+export type Operation = ClosedEnum<typeof Operation>;
+
+export const Operation$zodSchema = z.enum([
+  "add",
+  "remove",
+]).describe(
+  "The operation to perform on the principal’s role assignments. `add` grants the specified roles; `remove` revokes them.",
+);
+
+export type AssignFolderRolesRequest = {
+  principal: Principal;
+  operation: Operation;
+  roles: Array<string>;
+};
+
+export const AssignFolderRolesRequest$zodSchema: z.ZodType<
+  AssignFolderRolesRequest
+> = z.object({
+  operation: Operation$zodSchema,
+  principal: z.lazy(() => Principal$zodSchema),
+  roles: z.array(z.string()),
+});

package/src/models/destroyassetop.ts

@@ -32,22 +32,24 @@ export const DestroyAssetRequest$zodSchema: z.ZodType<DestroyAssetRequest> = z
   });
 
 /**
- * Indicates successful deletion
+ * Result of the deletion operation
  */
 export const DestroyAssetResult = {
   Ok: "ok",
+  NotFound: "not found",
 } as const;
 /**
- * Indicates successful deletion
+ * Result of the deletion operation
  */
 export type DestroyAssetResult = ClosedEnum<typeof DestroyAssetResult>;
 
 export const DestroyAssetResult$zodSchema = z.enum([
   "ok",
-]).describe("Indicates successful deletion");
+  "not found",
+]).describe("Result of the deletion operation");
 
 /**
- * Asset/resource destroyed successfully
+ * Asset/resource destroyed successfully or not found
  */
 export type DestroyAssetResponseBody = {
   result?: DestroyAssetResult | undefined;
@@ -57,7 +59,7 @@ export const DestroyAssetResponseBody$zodSchema: z.ZodType<
   DestroyAssetResponseBody
 > = z.object({
   result: DestroyAssetResult$zodSchema.optional(),
-}).describe("Asset/resource destroyed successfully");
+}).describe("Asset/resource destroyed successfully or not found");
 
 export type DestroyAssetResponse = ApiError | DestroyAssetResponseBody;