@shuffll/mcp-server 1.0.0

package/build/tools/edit-tools.js

@@ -0,0 +1,290 @@
+import { z } from "zod";
+import { ShufflApiError } from "../api-client.js";
+function formatError(error) {
+    if (error instanceof ShufflApiError) {
+        return `Shuffll API error (${error.statusCode}): ${JSON.stringify(error.responseBody)}`;
+    }
+    if (error instanceof Error) {
+        return `Error: ${error.message}`;
+    }
+    return `Unknown error: ${String(error)}`;
+}
+export function registerEditTools(server, apiClient, _config) {
+    // ----------------------------------------------------------------
+    // create_edit
+    // ----------------------------------------------------------------
+    server.tool("create_edit", "Create a default edit (video compilation) for a project. This automatically configures the edit with all scenes and their selected takes. Returns the full project with the new edit.", {
+        projectId: z.string().describe("The project ID"),
+    }, async (args) => {
+        try {
+            const result = await apiClient.createDefaultEdit(args.projectId);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // configure_edit
+    // ----------------------------------------------------------------
+    server.tool("configure_edit", "Update edit configuration properties. Common properties: 'exportQuality' (1080, 720, 480), 'aspectRatio' ('16/9', '1/1', '9/16'), 'toCleanAudio' (boolean), 'toAddWatermark' (boolean), 'toSegmentVideo' (boolean).", {
+        projectId: z.string().describe("The project ID"),
+        editId: z.string().describe("The edit ID to configure"),
+        properties: z
+            .array(z.object({
+            key: z.string().describe("Property key"),
+            value: z.any().describe("Property value"),
+        }))
+            .describe("Array of properties to update (e.g., [{ key: 'exportQuality', value: 1080 }])"),
+    }, async (args) => {
+        try {
+            const result = await apiClient.updateEditProperty(args.projectId, args.editId, args.properties);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // update_edit_shots
+    // ----------------------------------------------------------------
+    server.tool("update_edit_shots", "Update which scene/take pairs are included in the edit timeline and their order. Each shot references a scene and its selected take.", {
+        projectId: z.string().describe("The project ID"),
+        editId: z.string().describe("The edit ID"),
+        selectedShots: z
+            .array(z.object({
+            sceneId: z.string().describe("Scene ID"),
+            takeId: z.string().describe("Take ID from the scene"),
+            trims: z
+                .object({
+                videoTrims: z
+                    .object({
+                    start: z.number(),
+                    end: z.number(),
+                })
+                    .optional(),
+                lottieTrims: z
+                    .object({
+                    start: z.number(),
+                    end: z.number(),
+                })
+                    .optional(),
+            })
+                .optional()
+                .describe("Optional trim settings for this shot"),
+        }))
+            .describe("Array of scene/take pairs defining the edit timeline order"),
+    }, async (args) => {
+        try {
+            const result = await apiClient.updateEditShots(args.projectId, args.editId, args.selectedShots);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // export_video
+    // ----------------------------------------------------------------
+    server.tool("export_video", "Start exporting/rendering the final video. Returns the edit ID. Use get_export_status to track rendering progress and get the download URLs when complete.", {
+        projectId: z.string().describe("The project ID"),
+        editId: z
+            .string()
+            .describe("The edit ID to export"),
+    }, async (args) => {
+        try {
+            const result = await apiClient.exportEdit(args.projectId, args.editId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            ...result,
+                            message: "Export started. Use get_export_status to track progress.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // get_export_status
+    // ----------------------------------------------------------------
+    server.tool("get_export_status", "Check the export/rendering progress of a video. Returns whether it is done and the download URLs (uploadPath for MP4, dashPath for DASH streaming) when complete.", {
+        projectId: z.string().describe("The project ID"),
+        editId: z.string().describe("The edit ID to check"),
+    }, async (args) => {
+        try {
+            const result = await apiClient.getExportStatus(args.projectId, args.editId);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // get_enhance_status
+    // ----------------------------------------------------------------
+    server.tool("get_enhance_status", "Check the enhancement progress of a video edit. Enhancements include AI voice generation, subtitle generation, audio cleaning, and video segmentation. Returns percentage and done status.", {
+        projectId: z.string().describe("The project ID"),
+        editId: z.string().describe("The edit ID to check"),
+    }, async (args) => {
+        try {
+            const result = await apiClient.getEnhanceStatus(args.projectId, args.editId);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // generate_ai_voice
+    // ----------------------------------------------------------------
+    server.tool("generate_ai_voice", "Trigger AI text-to-speech voice generation for all scenes in an edit. This generates audio from the scene scripts using the project's AI voice settings.", {
+        projectId: z.string().describe("The project ID"),
+        editId: z.string().describe("The edit ID"),
+    }, async (args) => {
+        try {
+            const result = await apiClient.generateAiVoiceForEdit(args.projectId, args.editId);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // update_background_music
+    // ----------------------------------------------------------------
+    server.tool("update_background_music", "Update background music settings for an edit. Properties include 'volume' (0-1), 'toFadeAudio' (boolean), 'path' (music file path).", {
+        projectId: z.string().describe("The project ID"),
+        editId: z.string().describe("The edit ID"),
+        properties: z
+            .array(z.object({
+            key: z.string().describe("BGM property key (e.g., 'volume', 'toFadeAudio')"),
+            value: z.any().describe("The new value"),
+        }))
+            .describe("Array of background music properties to update"),
+    }, async (args) => {
+        try {
+            const result = await apiClient.updateBGMusic(args.projectId, args.editId, args.properties);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // update_ai_voice_settings
+    // ----------------------------------------------------------------
+    server.tool("update_ai_voice_settings", "Update AI voice settings for a project. Settings include 'voiceId' (voice identifier), 'voiceSpeed' (playback speed multiplier), 'voiceInstructions' (text instructions for the AI voice), 'voiceType' (voice category).", {
+        projectId: z.string().describe("The project ID"),
+        key: z
+            .string()
+            .describe("Setting to update: 'voiceId', 'voiceSpeed', 'voiceInstructions', 'voiceType'"),
+        value: z.any().describe("New value for the setting"),
+        regenerateVoice: z
+            .boolean()
+            .default(false)
+            .describe("Whether to regenerate the AI voice immediately after updating the setting"),
+    }, async (args) => {
+        try {
+            const result = await apiClient.updateAiVoice(args.projectId, args.key, args.value, args.regenerateVoice);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // update_ai_avatar_settings
+    // ----------------------------------------------------------------
+    server.tool("update_ai_avatar_settings", "Update AI avatar settings for a project. Settings include 'avatarId' (avatar identifier), 'accent' (speech accent), 'avatarName' (display name), 'avatarType' (avatar category).", {
+        projectId: z.string().describe("The project ID"),
+        key: z
+            .string()
+            .describe("Setting to update: 'avatarId', 'accent', 'avatarName', 'avatarType'"),
+        value: z.any().describe("New value for the setting"),
+        regenerateVoice: z
+            .boolean()
+            .default(false)
+            .describe("Whether to regenerate the voice after changing avatar settings"),
+    }, async (args) => {
+        try {
+            const result = await apiClient.updateAiAvatar(args.projectId, args.key, args.value, args.regenerateVoice);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=edit-tools.js.map

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

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

package/build/tools/project-tools.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ShufflApiClient } from "../api-client.js";
+import { ShufflMcpConfig } from "../config.js";
+export declare function registerProjectTools(server: McpServer, apiClient: ShufflApiClient, _config: ShufflMcpConfig): void;

package/build/tools/project-tools.js

@@ -0,0 +1,179 @@
+import { z } from "zod";
+import { ShufflApiError } from "../api-client.js";
+function formatError(error) {
+    if (error instanceof ShufflApiError) {
+        return `Shuffll API error (${error.statusCode}): ${JSON.stringify(error.responseBody)}`;
+    }
+    if (error instanceof Error) {
+        return `Error: ${error.message}`;
+    }
+    return `Unknown error: ${String(error)}`;
+}
+export function registerProjectTools(server, apiClient, _config) {
+    // ----------------------------------------------------------------
+    // create_video_project
+    // ----------------------------------------------------------------
+    server.tool("create_video_project", "Create a new Shuffll video project from a text prompt. Returns the project ID. Use get_project_creation_status to poll progress, then get_project to retrieve full details once done.", {
+        prompt: z
+            .string()
+            .describe("Creative brief describing the video (e.g., 'A product demo for our new CRM software')"),
+        videoType: z
+            .enum(["ai-voice", "avatar", "camera", "mic"])
+            .default("ai-voice")
+            .describe("Type of video: 'ai-voice' for AI voiceover, 'avatar' for AI avatar, 'camera' for user-recorded video, 'mic' for audio-only recording"),
+        toneOfVoice: z
+            .enum([
+            "natural",
+            "professional",
+            "informative",
+            "inspirational",
+            "energetic",
+        ])
+            .default("natural")
+            .optional()
+            .describe("The tone of the generated script"),
+        language: z
+            .enum(["auto", "en", "iw", "es", "fr", "zh"])
+            .default("en")
+            .optional()
+            .describe("Language code for the video content"),
+        templateId: z
+            .string()
+            .optional()
+            .describe("Optional template ID to base the project on. Use the shuffll://templates resource to find available templates."),
+        autoEnhance: z
+            .boolean()
+            .default(true)
+            .optional()
+            .describe("Whether to auto-enhance the video (AI voice, images, etc.) after creation"),
+        autoExport: z
+            .boolean()
+            .default(true)
+            .optional()
+            .describe("Whether to auto-export the video after enhancement completes"),
+    }, async (args) => {
+        try {
+            const body = {
+                prompt: args.prompt,
+                recordingType: args.videoType,
+                toneOfVoice: args.toneOfVoice,
+                language: { code: args.language || "en" },
+                templateId: args.templateId,
+                toAutoEnhance: args.autoEnhance,
+                toAutoExport: args.autoExport,
+            };
+            const result = await apiClient.createProject(body);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            projectId: result.projectId,
+                            message: "Project creation started. Use get_project_creation_status to check progress.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // get_project
+    // ----------------------------------------------------------------
+    server.tool("get_project", "Get full details of a Shuffll video project including all scenes, takes, edits, status, and configuration.", {
+        projectId: z.string().describe("The project ID to retrieve"),
+    }, async (args) => {
+        try {
+            const project = await apiClient.getProject(args.projectId);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(project, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // get_project_creation_status
+    // ----------------------------------------------------------------
+    server.tool("get_project_creation_status", "Check the AI generation progress of a video project. Returns 'STRUCTURE' (generating scene structure), 'GENERATING_IMAGES' (creating visual assets), or 'DONE' (ready for editing/export). Poll this after create_video_project.", {
+        projectId: z.string().describe("The project ID to check"),
+    }, async (args) => {
+        try {
+            const status = await apiClient.getCreationStatus(args.projectId);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(status, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // update_project
+    // ----------------------------------------------------------------
+    server.tool("update_project", "Update a property of a video project. Common keys: 'name' (project name), 'statuses.general' (project status), 'aiVoiceSettings.voiceId', 'aiVoiceSettings.voiceSpeed'.", {
+        projectId: z.string().describe("The project ID to update"),
+        key: z
+            .string()
+            .describe("The property key to update (e.g., 'name', 'statuses.general')"),
+        value: z.any().describe("The new value for the property"),
+    }, async (args) => {
+        try {
+            const result = await apiClient.updateProject(args.projectId, args.key, args.value);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // delete_project
+    // ----------------------------------------------------------------
+    server.tool("delete_project", "Permanently delete a video project and all its associated data.", {
+        projectId: z.string().describe("The project ID to delete"),
+    }, async (args) => {
+        try {
+            await apiClient.deleteProject(args.projectId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            message: `Project ${args.projectId} deleted successfully.`,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=project-tools.js.map

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

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

package/build/tools/scene-tools.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ShufflApiClient } from "../api-client.js";
+import { ShufflMcpConfig } from "../config.js";
+export declare function registerSceneTools(server: McpServer, apiClient: ShufflApiClient, _config: ShufflMcpConfig): void;

package/build/tools/scene-tools.js

@@ -0,0 +1,157 @@
+import { z } from "zod";
+import { ShufflApiError } from "../api-client.js";
+function formatError(error) {
+    if (error instanceof ShufflApiError) {
+        return `Shuffll API error (${error.statusCode}): ${JSON.stringify(error.responseBody)}`;
+    }
+    if (error instanceof Error) {
+        return `Error: ${error.message}`;
+    }
+    return `Unknown error: ${String(error)}`;
+}
+export function registerSceneTools(server, apiClient, _config) {
+    // ----------------------------------------------------------------
+    // add_scene
+    // ----------------------------------------------------------------
+    server.tool("add_scene", "Add a new scene to a video project. Scenes are the building blocks of a video — each has a layout (composition) and content. Common composition types: 'vid_clean' (clean video), 'headline_and_subtitle_txt' (text overlay), 'img_single' (single image), 'logo_intro' (logo animation), 'cta_txt' (call to action).", {
+        projectId: z.string().describe("The project ID"),
+        compositionType: z
+            .string()
+            .describe("The composition/layout type for the new scene (e.g., 'vid_clean', 'headline_and_subtitle_txt', 'img_single', 'logo_intro', 'cta_txt'). Use get_project to see composition types of existing scenes."),
+        position: z
+            .enum(["before", "after"])
+            .default("after")
+            .optional()
+            .describe("Insert the scene before or after the reference scene"),
+        referenceSceneId: z
+            .string()
+            .optional()
+            .describe("The scene ID to position relative to. If omitted, the scene is added at the end."),
+    }, async (args) => {
+        try {
+            const relativePosition = args.referenceSceneId
+                ? {
+                    position: args.position || "after",
+                    sceneId: args.referenceSceneId,
+                }
+                : undefined;
+            const result = await apiClient.addScene(args.projectId, args.compositionType, relativePosition);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // update_scene
+    // ----------------------------------------------------------------
+    server.tool("update_scene", "Update a scene's properties. Common keys: 'copy.script' (voiceover script text), 'copy.directorTip' (recording directions), 'copy.imagePrompt' (AI image generation prompt), 'name' (scene title), 'isHidden' (hide from edit).", {
+        projectId: z.string().describe("The project ID"),
+        sceneId: z.string().describe("The scene ID to update"),
+        key: z
+            .string()
+            .describe("The property key to update (e.g., 'copy.script', 'name', 'isHidden')"),
+        value: z
+            .any()
+            .describe("The new value for the property"),
+    }, async (args) => {
+        try {
+            const result = await apiClient.updateScene(args.projectId, args.sceneId, args.key, args.value);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // update_scene_composition
+    // ----------------------------------------------------------------
+    server.tool("update_scene_composition", "Change the layout/composition type of an existing scene (e.g., switch from text-only to image+text).", {
+        projectId: z.string().describe("The project ID"),
+        sceneId: z.string().describe("The scene ID to update"),
+        compositionType: z
+            .string()
+            .describe("The new composition type (e.g., 'vid_clean', 'headline_and_subtitle_txt', 'img_single')"),
+    }, async (args) => {
+        try {
+            const result = await apiClient.updateSceneComposition(args.projectId, args.sceneId, args.compositionType);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // delete_scene
+    // ----------------------------------------------------------------
+    server.tool("delete_scene", "Remove a scene from a video project.", {
+        projectId: z.string().describe("The project ID"),
+        sceneId: z.string().describe("The scene ID to delete"),
+    }, async (args) => {
+        try {
+            await apiClient.deleteScene(args.projectId, args.sceneId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            message: `Scene ${args.sceneId} deleted successfully.`,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+    // ----------------------------------------------------------------
+    // generate_scene_script
+    // ----------------------------------------------------------------
+    server.tool("generate_scene_script", "Use AI to generate or regenerate the voiceover script for a specific scene, based on the overall project context and prompt.", {
+        projectId: z.string().describe("The project ID"),
+        sceneId: z
+            .string()
+            .describe("The scene ID to generate a script for"),
+    }, async (args) => {
+        try {
+            const result = await apiClient.writeSceneScript(args.projectId, args.sceneId);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatError(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=scene-tools.js.map