@agimon-ai/video-editor-mcp 0.2.0

package/LICENSE

@@ -0,0 +1,52 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             AgiFlow
+Licensed Work:        @agimon-ai/public-packages
+                      The Licensed Work is (c) 2026 AgiFlow.
+Additional Use Grant: None
+Change Date:          2030-03-06
+Change License:       Apache License, Version 2.0
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.

package/README.md

@@ -0,0 +1,42 @@
+# video-editor
+
+MCP server for video editing with FFmpeg/editly
+
+## Installation
+
+```bash
+pnpm install
+```
+
+## Development
+
+```bash
+pnpm dev
+```
+
+## Build
+
+```bash
+pnpm build
+```
+
+## Test
+
+```bash
+pnpm test
+```
+
+## Usage with Claude Code
+
+Add to your Claude Code configuration:
+
+```json
+{
+  "mcpServers": {
+    "video-editor": {
+      "command": "npx",
+      "args": ["video-editor", "mcp-serve"]
+    }
+  }
+}
+```

package/dist/cli.cjs

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+const require_stdio = require('./stdio-C-vwZanD.cjs');
+let commander = require("commander");
+let node_child_process = require("node:child_process");
+let node_path = require("node:path");
+node_path = require_stdio.__toESM(node_path);
+let chalk = require("chalk");
+chalk = require_stdio.__toESM(chalk);
+let node_fs = require("node:fs");
+node_fs = require_stdio.__toESM(node_fs);
+
+//#region package.json
+var version = "0.1.0";
+
+//#endregion
+//#region src/commands/http-serve.ts
+/**
+* HTTP Serve Command
+*
+* Starts Remotion Studio for interactive video editing.
+*/
+const httpServeCommand = new commander.Command("http-serve").description("Start Remotion Studio for video editing").option("-p, --port <port>", "Port to run Remotion Studio on", "3001").action(async (options) => {
+	try {
+		const port = parseInt(options.port, 10);
+		const packageDir = node_path.default.resolve(__dirname, "..");
+		console.error(chalk.default.green(`✓ Starting Remotion Studio on port ${port}...`));
+		console.error(chalk.default.gray(`  Working directory: ${packageDir}`));
+		const studio = (0, node_child_process.spawn)(node_path.default.join(packageDir, "node_modules", ".bin", "remotion"), [
+			"studio",
+			"--port",
+			String(port)
+		], {
+			stdio: "inherit",
+			cwd: packageDir
+		});
+		studio.on("error", (error) => {
+			console.error(chalk.default.red(`Failed to start Remotion Studio: ${error.message}`));
+			process.exit(1);
+		});
+		process.on("SIGINT", () => {
+			studio.kill("SIGINT");
+			process.exit(0);
+		});
+		process.on("SIGTERM", () => {
+			studio.kill("SIGTERM");
+			process.exit(0);
+		});
+	} catch (error) {
+		console.error("Error executing http-serve:", error);
+		process.exit(1);
+	}
+});
+
+//#endregion
+//#region src/commands/mcp-serve.ts
+/**
+* MCP Serve Command
+*
+* DESIGN PATTERNS:
+* - Command pattern with Commander for CLI argument parsing
+* - Transport abstraction pattern for flexible deployment (stdio, HTTP, SSE)
+* - Factory pattern for creating transport handlers
+* - Graceful shutdown pattern with signal handling
+*
+* CODING STANDARDS:
+* - Use async/await for asynchronous operations
+* - Implement proper error handling with try-catch blocks
+* - Handle process signals for graceful shutdown
+* - Provide clear CLI options and help messages
+*
+* AVOID:
+* - Hardcoded configuration values (use CLI options or environment variables)
+* - Missing error handling for transport startup
+* - Not cleaning up resources on shutdown
+*/
+/**
+* Start MCP server with given transport handler
+*/
+async function startServer(handler) {
+	await handler.start();
+	const shutdown = async (signal) => {
+		console.error(`\nReceived ${signal}, shutting down gracefully...`);
+		try {
+			await handler.stop();
+			process.exit(0);
+		} catch (error) {
+			console.error("Error during shutdown:", error);
+			process.exit(1);
+		}
+	};
+	process.on("SIGINT", () => shutdown("SIGINT"));
+	process.on("SIGTERM", () => shutdown("SIGTERM"));
+}
+/**
+* MCP Serve command
+*/
+const mcpServeCommand = new commander.Command("mcp-serve").description("Start MCP server with specified transport").option("-t, --type <type>", "Transport type: stdio", "stdio").action(async (options) => {
+	try {
+		const transportType = options.type.toLowerCase();
+		if (transportType === "stdio") await startServer(new require_stdio.StdioTransportHandler(require_stdio.createServer(require_stdio.createContainer())));
+		else {
+			console.error(`Unknown transport type: ${transportType}. Use: stdio`);
+			process.exit(1);
+		}
+	} catch (error) {
+		console.error("Failed to start MCP server:", error);
+		process.exit(1);
+	}
+});
+
+//#endregion
+//#region src/commands/render.ts
+/**
+* Render Command
+*
+* Renders a video from JSON props using Remotion.
+*/
+const renderCommand = new commander.Command("render").description("Render a video from JSON props file").requiredOption("-i, --input <path>", "Path to JSON props file").requiredOption("-o, --output <path>", "Output video file path").option("-c, --composition <id>", "Composition ID", "Main").option("--codec <codec>", "Video codec (h264, h265, vp8, vp9)", "h264").action(async (options) => {
+	try {
+		process.stderr.write(chalk.default.blue("🎬 Starting video render...\n"));
+		process.stderr.write(chalk.default.gray(`  Input: ${options.input}\n`));
+		process.stderr.write(chalk.default.gray(`  Output: ${options.output}\n`));
+		process.stderr.write(chalk.default.gray(`  Composition: ${options.composition}\n`));
+		process.stderr.write(chalk.default.gray(`  Codec: ${options.codec}\n`));
+		if (!node_fs.default.existsSync(options.input)) {
+			process.stderr.write(chalk.default.red(`Error: Input file not found: ${options.input}\n`));
+			process.exit(1);
+		}
+		const propsContent = node_fs.default.readFileSync(options.input, "utf-8");
+		const inputProps = JSON.parse(propsContent);
+		const renderService = require_stdio.createContainer().get(require_stdio.TYPES.RenderService);
+		process.stderr.write(chalk.default.blue("📦 Bundling Remotion project...\n"));
+		const result = await renderService.render({
+			compositionId: options.composition,
+			inputProps,
+			outputPath: options.output,
+			codec: options.codec
+		});
+		process.stderr.write(chalk.default.green(`✓ Video rendered successfully: ${result.outputPath}\n`));
+	} catch (error) {
+		process.stderr.write(chalk.default.red(`Error rendering video: ${error}\n`));
+		process.exit(1);
+	}
+});
+
+//#endregion
+//#region src/cli.ts
+/**
+* MCP Server Entry Point
+*
+* DESIGN PATTERNS:
+* - CLI pattern with Commander for argument parsing
+* - Command pattern for organizing CLI commands
+* - Transport abstraction for multiple communication methods
+*
+* CODING STANDARDS:
+* - Use async/await for asynchronous operations
+* - Handle errors gracefully with try-catch
+* - Log important events for debugging
+* - Register all commands in main entry point
+*
+* AVOID:
+* - Hardcoding command logic in index.ts (use separate command files)
+* - Missing error handling for command execution
+*/
+/**
+* Main entry point
+*/
+async function main() {
+	const program = new commander.Command();
+	program.name("video-editor-mcp").description("MCP server for video editing with Remotion").version(version);
+	program.addCommand(mcpServeCommand);
+	program.addCommand(httpServeCommand);
+	program.addCommand(renderCommand);
+	await program.parseAsync(process.argv);
+}
+main();
+
+//#endregion

package/dist/cli.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,177 @@
+#!/usr/bin/env node
+import { d as TYPES, n as createServer, r as createContainer, t as StdioTransportHandler } from "./stdio-C7h0m1FD.mjs";
+import { Command } from "commander";
+import { spawn } from "node:child_process";
+import path from "node:path";
+import chalk from "chalk";
+import fs from "node:fs";
+
+//#region package.json
+var version = "0.1.0";
+
+//#endregion
+//#region src/commands/http-serve.ts
+/**
+* HTTP Serve Command
+*
+* Starts Remotion Studio for interactive video editing.
+*/
+const httpServeCommand = new Command("http-serve").description("Start Remotion Studio for video editing").option("-p, --port <port>", "Port to run Remotion Studio on", "3001").action(async (options) => {
+	try {
+		const port = parseInt(options.port, 10);
+		const packageDir = path.resolve(import.meta.dirname, "..");
+		console.error(chalk.green(`✓ Starting Remotion Studio on port ${port}...`));
+		console.error(chalk.gray(`  Working directory: ${packageDir}`));
+		const studio = spawn(path.join(packageDir, "node_modules", ".bin", "remotion"), [
+			"studio",
+			"--port",
+			String(port)
+		], {
+			stdio: "inherit",
+			cwd: packageDir
+		});
+		studio.on("error", (error) => {
+			console.error(chalk.red(`Failed to start Remotion Studio: ${error.message}`));
+			process.exit(1);
+		});
+		process.on("SIGINT", () => {
+			studio.kill("SIGINT");
+			process.exit(0);
+		});
+		process.on("SIGTERM", () => {
+			studio.kill("SIGTERM");
+			process.exit(0);
+		});
+	} catch (error) {
+		console.error("Error executing http-serve:", error);
+		process.exit(1);
+	}
+});
+
+//#endregion
+//#region src/commands/mcp-serve.ts
+/**
+* MCP Serve Command
+*
+* DESIGN PATTERNS:
+* - Command pattern with Commander for CLI argument parsing
+* - Transport abstraction pattern for flexible deployment (stdio, HTTP, SSE)
+* - Factory pattern for creating transport handlers
+* - Graceful shutdown pattern with signal handling
+*
+* CODING STANDARDS:
+* - Use async/await for asynchronous operations
+* - Implement proper error handling with try-catch blocks
+* - Handle process signals for graceful shutdown
+* - Provide clear CLI options and help messages
+*
+* AVOID:
+* - Hardcoded configuration values (use CLI options or environment variables)
+* - Missing error handling for transport startup
+* - Not cleaning up resources on shutdown
+*/
+/**
+* Start MCP server with given transport handler
+*/
+async function startServer(handler) {
+	await handler.start();
+	const shutdown = async (signal) => {
+		console.error(`\nReceived ${signal}, shutting down gracefully...`);
+		try {
+			await handler.stop();
+			process.exit(0);
+		} catch (error) {
+			console.error("Error during shutdown:", error);
+			process.exit(1);
+		}
+	};
+	process.on("SIGINT", () => shutdown("SIGINT"));
+	process.on("SIGTERM", () => shutdown("SIGTERM"));
+}
+/**
+* MCP Serve command
+*/
+const mcpServeCommand = new Command("mcp-serve").description("Start MCP server with specified transport").option("-t, --type <type>", "Transport type: stdio", "stdio").action(async (options) => {
+	try {
+		const transportType = options.type.toLowerCase();
+		if (transportType === "stdio") await startServer(new StdioTransportHandler(createServer(createContainer())));
+		else {
+			console.error(`Unknown transport type: ${transportType}. Use: stdio`);
+			process.exit(1);
+		}
+	} catch (error) {
+		console.error("Failed to start MCP server:", error);
+		process.exit(1);
+	}
+});
+
+//#endregion
+//#region src/commands/render.ts
+/**
+* Render Command
+*
+* Renders a video from JSON props using Remotion.
+*/
+const renderCommand = new Command("render").description("Render a video from JSON props file").requiredOption("-i, --input <path>", "Path to JSON props file").requiredOption("-o, --output <path>", "Output video file path").option("-c, --composition <id>", "Composition ID", "Main").option("--codec <codec>", "Video codec (h264, h265, vp8, vp9)", "h264").action(async (options) => {
+	try {
+		process.stderr.write(chalk.blue("🎬 Starting video render...\n"));
+		process.stderr.write(chalk.gray(`  Input: ${options.input}\n`));
+		process.stderr.write(chalk.gray(`  Output: ${options.output}\n`));
+		process.stderr.write(chalk.gray(`  Composition: ${options.composition}\n`));
+		process.stderr.write(chalk.gray(`  Codec: ${options.codec}\n`));
+		if (!fs.existsSync(options.input)) {
+			process.stderr.write(chalk.red(`Error: Input file not found: ${options.input}\n`));
+			process.exit(1);
+		}
+		const propsContent = fs.readFileSync(options.input, "utf-8");
+		const inputProps = JSON.parse(propsContent);
+		const renderService = createContainer().get(TYPES.RenderService);
+		process.stderr.write(chalk.blue("📦 Bundling Remotion project...\n"));
+		const result = await renderService.render({
+			compositionId: options.composition,
+			inputProps,
+			outputPath: options.output,
+			codec: options.codec
+		});
+		process.stderr.write(chalk.green(`✓ Video rendered successfully: ${result.outputPath}\n`));
+	} catch (error) {
+		process.stderr.write(chalk.red(`Error rendering video: ${error}\n`));
+		process.exit(1);
+	}
+});
+
+//#endregion
+//#region src/cli.ts
+/**
+* MCP Server Entry Point
+*
+* DESIGN PATTERNS:
+* - CLI pattern with Commander for argument parsing
+* - Command pattern for organizing CLI commands
+* - Transport abstraction for multiple communication methods
+*
+* CODING STANDARDS:
+* - Use async/await for asynchronous operations
+* - Handle errors gracefully with try-catch
+* - Log important events for debugging
+* - Register all commands in main entry point
+*
+* AVOID:
+* - Hardcoding command logic in index.ts (use separate command files)
+* - Missing error handling for command execution
+*/
+/**
+* Main entry point
+*/
+async function main() {
+	const program = new Command();
+	program.name("video-editor-mcp").description("MCP server for video editing with Remotion").version(version);
+	program.addCommand(mcpServeCommand);
+	program.addCommand(httpServeCommand);
+	program.addCommand(renderCommand);
+	await program.parseAsync(process.argv);
+}
+main();
+
+//#endregion
+export {  };