RunComfy MCP Server

MCP server to generate AI videos and images using the RunComfy APIs.

Setup

1. Install dependencies:

2. Get your API key from: https://www.runcomfy.com/profile

3. Add the configuration to your ~/.windsurf/mcp_config.json:

4. Restart Windsurf

Available tools

runcomfy_generate_video

Generate an AI video. Parameters:

• prompt (required): Video description

• model: wan-2.1, wan-2.1-720p, animatediff, svd, kling, minimax

• image_url: Image URL for image-to-video models

• duration: Duration in seconds

• aspect_ratio: 16:9, 9:16, 1:1

• seed: Seed for reproducibility

runcomfy_generate_image

Generate an AI image (text-to-image). Parameters:

• prompt (required): Image description

• model: flux-2-pro

• aspect_ratio: 16:9, 9:16, 1:1

• seed: Seed for reproducibility

• inputs: Advanced model-specific inputs (object)

runcomfy_edit_image

Edit an image (image-to-image). Parameters:

• prompt (required): Edit instruction

• model: flux-2-dev-edit, flux-kontext-pro-edit, qwen-edit-next-scene

• image_url: Single image URL (some models)

• image_urls: Multiple image URLs (some models)

• aspect_ratio: 16:9, 9:16, 1:1

• seed: Seed for reproducibility

• inputs: Advanced model-specific inputs (object)

runcomfy_check_status

Check the status of a request.

runcomfy_get_result

Get the result (video URL) of a completed request.

runcomfy_cancel

Cancel a queued request.

runcomfy_list_models

List available models plus curated alias maps for video and image.

Usage example