Fal MCP Server

Fal MCP Server

Generate AI images, videos, and music using Fal.ai models (FLUX, Stable Diffusion, MusicGen) directly in Claude

13
Stars
4
Forks
3
Releases

Overview

Fal.ai MCP Server is a Model Context Protocol (MCP) server that enables Claude Desktop (and other MCP clients) to generate media using Fal.ai models. It exposes a high-performance, asynchronous API built on fal_client.run_async(), with support for long-running tasks via a queue API that provides progress updates. The server is non-blocking, ensuring responsive behavior as tasks execute in the background. It supports multiple transport modes: STDIO for traditional MCP communication, HTTP/SSE for web-based access via Server-Sent Events, and a dual mode that runs both transports concurrently. This makes it suitable for both CLI workflows and web clients. Supported media capabilities include image generation (flux_schnell, flux_dev, sdxl), video generation (svd, animatediff), and audio generation (musicgen), as well as text-to-speech (bark) and transcription (whisper), image upscaling, and image-to-image transformations. Quick Start covers Docker, PyPI, and source installations, along with Claude Desktop configuration. Documentation references Docker and HTTP transport usage, and the MCP 1.0 specification is acknowledged. The server is designed to simplify the integration of Fal.ai models into Claude Desktop and other MCP clients.

Details

Owner
raveenb
Language
Python
License
MIT License
Updated
2025-12-07

Features

Native Async API

Uses fal_client.run_async() for optimal performance.

Queue Support

Long-running tasks (video/music) use queue API with progress updates.

Non-blocking

All operations are truly asynchronous.

STDIO Transport

Traditional MCP communication for model context protocol.

HTTP/SSE Transport

Web-based access via Server-Sent Events.

Dual Transport

Run both STDIO and HTTP transports simultaneously.

Image Generation

Create images using Flux, SDXL, and other Fal.ai models.

Video Generation

Generate videos from images or text prompts.

Audience

MCP developersCreate and deploy MCP servers enabling Fal.ai media generation for Claude Desktop and MCP clients.
Claude Desktop usersInteract with MCP server to generate images, videos, music, and audio via Claude Desktop.

Tags

Fal.aiMCP 1.0MCP serverImage GenerationVideo GenerationMusic GenerationText-to-SpeechAudio TranscriptionImage UpscalingImage-to-ImageSTDIO TransportHTTP/SSE TransportDual TransportClaude DesktopFluxSDXLStable Diffusion XLSVDanimatediffMusicGenWhisper