@shuffll/mcp-server 1.0.0

package/build/tools/scene-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-tools.js","sourceRoot":"","sources":["../../src/tools/scene-tools.ts"],"names":[],"mappings":"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"}

package/build/types.d.ts

@@ -0,0 +1,169 @@
+export type ProjectRecordingType = "camera" | "mic" | "ai-voice" | "avatar";
+export type ProjectStatus = "planning" | "recording" | "editing" | "exporting" | "export-failed" | "done";
+export type ToneOfVoice = "natural" | "professional" | "informative" | "inspirational" | "energetic";
+export type LanguageCode = "auto" | "en" | "iw" | "es" | "fr" | "zh";
+export type ExportQuality = 1080 | 720 | 480;
+export type AspectRatio = "16/9" | "1/1" | "9/16";
+export type EditJobStatus = "dummy" | "started" | "in_progress" | "segmented" | "composed" | "dashed" | "generated_thumbnails" | "trimmed" | "fused" | "audio_cleaned" | "muxed" | "completed" | "no-video";
+export type EnhanceStatus = "none" | "in_progress" | "done";
+export type AiVoiceStatus = "not_started" | "on_processing" | "done";
+export type CreativeStatus = "STRUCTURE" | "GENERATING_IMAGES" | "DONE";
+export type RewriteType = "improve" | "conversational" | "shorten" | "expand" | "formal" | "friendly" | "confident" | "persuasive";
+export interface CreateProjectRequest {
+    prompt: string;
+    recordingType: ProjectRecordingType;
+    toneOfVoice?: ToneOfVoice;
+    language?: {
+        code: LanguageCode;
+    };
+    templateId?: string;
+    designGroupId?: string;
+    designId?: string;
+    toAutoEnhance?: boolean;
+    toAutoExport?: boolean;
+    webhook?: string;
+    videoLength?: number;
+    seedForAiAudioCreation?: number;
+}
+export interface UpdatePropertyRequest {
+    key: string;
+    value: unknown;
+}
+export interface UpdatePropertiesRequest {
+    propertiesToUpdate: UpdatePropertyRequest[];
+    socketIdToExclude?: string | null;
+}
+export interface ProjectCreationResponse {
+    projectId: string;
+}
+export interface CreationStatusResponse {
+    status: CreativeStatus;
+}
+export interface PathAndDash {
+    uploadPath: string;
+    dashPath: string;
+}
+export interface ExportStatusResponse {
+    isDone: boolean;
+    urls?: PathAndDash;
+}
+export interface EnhanceStatusResponse {
+    isDone: boolean;
+    percentages: number;
+}
+export interface SceneCopy {
+    compositionType?: string;
+    script?: string;
+    directorTip?: string;
+    imagePrompt?: string;
+}
+export interface SceneOutDTO {
+    id: string;
+    name?: string;
+    takes: TakeOutDTO[];
+    selectedTakeId?: string;
+    isHidden?: boolean;
+    copy?: SceneCopy;
+    isGraphicScene?: boolean;
+    aiVoiceStatus?: AiVoiceStatus;
+    aiAvatarStatus?: AiVoiceStatus;
+    compositionType?: string;
+}
+export interface TakeOutDTO {
+    id: string;
+    status?: string;
+    duration?: number;
+    startTime?: number;
+    endTime?: number;
+    copy?: {
+        dynamicLottieChanges?: unknown[];
+        transcript?: unknown[];
+    };
+}
+export interface EditExports {
+    originalExported?: PathAndDash;
+    exportedWithAudioClean?: PathAndDash;
+}
+export interface EnhanceStatuses {
+    voiceClean?: EnhanceStatus;
+    segmentation?: EnhanceStatus;
+    subtitles?: EnhanceStatus;
+    textToSpeech?: EnhanceStatus;
+}
+export interface EditOutDTO {
+    id: string;
+    exportQuality?: ExportQuality;
+    aspectRatio?: AspectRatio;
+    status?: EditJobStatus;
+    exports?: EditExports;
+    videoEditTakes?: unknown[];
+    plugins?: unknown;
+    bgMusic?: unknown;
+    enhanceStatuses?: EnhanceStatuses;
+    toCleanAudio?: boolean;
+    toSegmentVideo?: boolean;
+    toAddWatermark?: boolean;
+    chosenTranscriptLanguage?: string;
+}
+export interface ProjectOutDTO {
+    id: string;
+    name?: string;
+    shortTitle?: string;
+    scenes: SceneOutDTO[];
+    edits: EditOutDTO[];
+    statuses?: {
+        general: ProjectStatus;
+    };
+    videoType?: string;
+    creative?: {
+        status: CreativeStatus;
+        prompt?: string;
+        videoTagId?: string;
+    };
+    branding?: unknown;
+    aiVoiceSettings?: {
+        voiceId?: string;
+        voiceInstructions?: string;
+        voiceSpeed?: number;
+        voiceType?: string;
+    };
+    aiAvatarSettings?: {
+        avatarId?: string;
+        accent?: string;
+        avatarName?: string;
+        avatarType?: string;
+    };
+    language?: string;
+    designGroup?: unknown;
+}
+export interface ScriptSuggestionResponse {
+    suggestions: string[];
+}
+export interface SelectedShot {
+    sceneId: string;
+    takeId: string;
+    trims?: {
+        videoTrims?: {
+            start: number;
+            end: number;
+        };
+        lottieTrims?: {
+            start: number;
+            end: number;
+        };
+    };
+}
+export interface TemplateOutDTO {
+    id: string;
+    name?: string;
+    description?: string;
+    scenes?: unknown[];
+    designGroup?: unknown;
+    [key: string]: unknown;
+}
+export interface PromptSuggestion {
+    tag: {
+        title: string;
+    };
+    suggestions: string[];
+}

package/build/types.js

@@ -0,0 +1,5 @@
+// ============================================================
+// Enums (mirroring Shuffll API defines)
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,wCAAwC;AACxC,+DAA+D"}

package/build/utils/logger.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Logger that writes to stderr only (stdout is reserved for MCP stdio transport).
+ */
+export declare function log(message: string, ...args: unknown[]): void;
+export declare function logError(message: string, error?: unknown): void;

package/build/utils/logger.js

@@ -0,0 +1,15 @@
+/**
+ * Logger that writes to stderr only (stdout is reserved for MCP stdio transport).
+ */
+export function log(message, ...args) {
+    console.error(`[shuffll-mcp] ${message}`, ...args);
+}
+export function logError(message, error) {
+    if (error instanceof Error) {
+        console.error(`[shuffll-mcp] ERROR: ${message}`, error.message);
+    }
+    else {
+        console.error(`[shuffll-mcp] ERROR: ${message}`, error);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/build/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,GAAG,IAAe;IACrD,OAAO,CAAC,KAAK,CAAC,iBAAiB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,KAAe;IACvD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,wBAAwB,OAAO,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,wBAAwB,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC"}

package/build/utils/polling.d.ts

@@ -0,0 +1,5 @@
+export interface PollOptions {
+    intervalMs: number;
+    timeoutMs: number;
+}
+export declare function pollUntilDone<T>(checkFn: () => Promise<T>, isDoneFn: (result: T) => boolean, options: PollOptions): Promise<T>;

package/build/utils/polling.js

@@ -0,0 +1,11 @@
+export async function pollUntilDone(checkFn, isDoneFn, options) {
+    const start = Date.now();
+    while (Date.now() - start < options.timeoutMs) {
+        const result = await checkFn();
+        if (isDoneFn(result))
+            return result;
+        await new Promise((resolve) => setTimeout(resolve, options.intervalMs));
+    }
+    throw new Error(`Polling timed out after ${options.timeoutMs}ms`);
+}
+//# sourceMappingURL=polling.js.map

package/build/utils/polling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.js","sourceRoot":"","sources":["../../src/utils/polling.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAyB,EACzB,QAAgC,EAChC,OAAoB;IAEpB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC;QAC/B,IAAI,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACpC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;AACpE,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@shuffll/mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Shuffll video creation API",
+  "type": "module",
+  "bin": {
+    "shuffll-mcp-server": "./build/index.js"
+  },
+  "main": "./build/index.js",
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "start": "node build/index.js",
+    "dev": "npx tsx src/index.ts",
+    "inspector": "npx @modelcontextprotocol/inspector build/index.js"
+  },
+  "files": [
+    "build/",
+    "README.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0",
+    "tsx": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}