raveenb/fal-mcp-server

raveenb/fal-mcp-server

от raveenb
MCP сервер для генерации изображений, видео, музыки и аудио через Fal.ai. Интегрируется с Claude Desktop и любыми MCP-клиентами, предлагая 18 инструментов: от текстовых промптов до ретуши и анимации. Полезен разработчикам и креаторам для быстрого создания контента без переключения между сервисами.

🎨 Fal.ai MCP Server

CI Docker MCP GitHub Release PyPI Docker Image Python License

A Model Context Protocol (MCP) server that enables Claude Desktop (and other MCP clients) to generate images, videos, music, and audio using Fal.ai models.

Fal.ai Server MCP server

✨ Features

🚀 Performance

  • 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

🌐 Transport Modes (New!)

  • STDIO - Traditional Model Context Protocol communication
  • HTTP/SSE - Web-based access via Server-Sent Events
  • Dual Mode - Run both transports simultaneously

🎨 Media Generation (18 Tools)

Image Generation:

  • 🖼️ generate_image - Create images from text prompts (Flux, SDXL, etc.)
  • 🎯 generate_image_structured - Fine-grained control over composition, lighting, subjects
  • 🔄 generate_image_from_image - Transform existing images with style transfer

Image Editing:

  • ✂️ remove_background - Remove backgrounds from images (transparent PNG)
  • 🔍 upscale_image - Upscale images 2x or 4x while preserving quality
  • ✏️ edit_image - Edit images using natural language instructions
  • 🎭 inpaint_image - Edit specific regions using masks
  • 📐 resize_image - Smart resize for social media (Instagram, YouTube, TikTok, etc.)
  • 🏷️ compose_images - Overlay images (watermarks, logos) with precise positioning
compose_images

Накладывает одно изображение поверх другого (например, водяной знак, логотип). Использует PIL для точного позиционирования - без ИИ.

Накладывает одно изображение поверх другого (например, водяной знак, логотип). Использует PIL для точного позиционирования - без ИИ.

Параметры

  • base_image_urlstringобязательный

    URL of the background/base image

  • overlay_image_urlstringобязательный

    URL of the image to overlay (e.g., logo, watermark). Use upload_file for local images.

  • positionenum

    Where to place the overlay. Use 'custom' with x,y for exact positioning.

    top-lefttop-rightbottom-leftbottom-rightcentercustom
  • xinteger

    Custom X position in pixels (required if position='custom')

  • yinteger

    Custom Y position in pixels (required if position='custom')

  • scalenumber

    Scale overlay relative to base image width (0.01-1.0). Default 0.15 = 15% of base width.

  • paddinginteger

    Padding from edges in pixels (for preset positions)

  • opacitynumber

    Overlay opacity (0.0=transparent, 1.0=opaque)

  • output_formatenum

    Output image format

    pngjpegwebp
edit_image

Редактируйте изображение с помощью инструкций на естественном языке. Опишите, какие изменения вы хотите, и ИИ применит их.

Редактируйте изображение с помощью инструкций на естественном языке. Опишите, какие изменения вы хотите, и ИИ применит их.

Параметры

  • image_urlstringобязательный

    URL of the image to edit (use upload_file for local images)

  • instructionstringобязательный

    Natural language description of the edit (e.g., 'make the sky more dramatic', 'change the car color to red')

  • modelstring

    Editing model. Options: fal-ai/flux-2/edit, fal-ai/flux-2-pro/edit (higher quality)

  • strengthnumber

    How much to change the image (0=minimal, 1=maximum)

  • seedinteger

    Seed for reproducible edits

generate_image

Генерирует изображения по текстовым запросам. Используйте list_models с category='image', чтобы узнать доступные модели.

Генерирует изображения по текстовым запросам. Используйте list_models с category='image', чтобы узнать доступные модели.

Параметры

  • promptstringобязательный

    Text description of the image to generate

  • modelstring

    Model ID (e.g., 'fal-ai/flux-pro') or alias (e.g., 'flux_schnell'). Use list_models to see options.

  • negative_promptstring

    What to avoid in the image

  • image_sizeenum
    squarelandscape_4_3landscape_16_9portrait_3_4portrait_9_16
  • num_imagesinteger
  • seedinteger

    Seed for reproducible generation

  • enable_safety_checkerboolean

    Enable safety checker to filter inappropriate content

  • output_formatenum

    Output image format

    jpegpngwebp
generate_image_from_image

Преобразует существующее изображение в новое на основе подсказки. Используйте для переноса стиля, редактирования, создания вариаций и других задач. Если у вас локальное изображение, сначала используйте upload_file.

Преобразует существующее изображение в новое на основе подсказки. Используйте для переноса стиля, редактирования, создания вариаций и других задач. Если у вас локальное изображение, сначала используйте upload_file.

Параметры

  • image_urlstringобязательный

    URL of the source image to transform (use upload_file for local images)

  • promptstringобязательный

    Text description of desired transformation (e.g., 'Transform into a watercolor painting')

  • modelstring

    Image-to-image model. Options: fal-ai/flux/dev/image-to-image, fal-ai/flux-2/edit

  • strengthnumber

    How much to transform (0=keep original, 1=ignore original)

  • num_imagesinteger
  • negative_promptstring

    What to avoid in the output image

  • seedinteger

    Seed for reproducible generation

  • enable_safety_checkerboolean

    Enable safety checker to filter inappropriate content

  • output_formatenum

    Output image format

    jpegpngwebp
generate_image_structured

Генерируйте изображения с подробными структурированными запросами для точного контроля композиции, стиля, освещения и объектов. Идеально подходит для AI-агентов, которым нужен детальный контроль.

Генерируйте изображения с подробными структурированными запросами для точного контроля композиции, стиля, освещения и объектов. Идеально подходит для AI-агентов, которым нужен детальный контроль.

Параметры

  • scenestringобязательный

    Overall scene description - the main subject and setting

  • subjectsobject[]

    List of subjects with their positions and descriptions

  • stylestring

    Art style (e.g., 'Digital art painting', 'Photorealistic', 'Watercolor', 'Oil painting')

  • color_palettestring[]

    Hex color codes for the palette (e.g., ['#000033', '#6A0DAD', '#FFFFFF'])

  • lightingstring

    Lighting description (e.g., 'Soft golden hour lighting', 'Dramatic chiaroscuro')

  • moodstring

    Emotional mood of the image (e.g., 'Serene', 'Dramatic', 'Mysterious')

  • backgroundstring

    Background description

  • compositionstring

    Compositional rules (e.g., 'Rule of thirds', 'Centered', 'Golden ratio')

  • cameraobject

    Camera settings for photographic style control

  • effectsstring[]

    Visual effects (e.g., ['Bokeh', 'Light rays', 'Lens flare', 'Motion blur'])

  • negative_promptstring

    What to avoid in the image (e.g., 'blurry, low quality, distorted')

  • modelstring

    Model ID or alias. Use list_models to see options.

  • image_sizeenum
    squarelandscape_4_3landscape_16_9portrait_3_4portrait_9_16
  • num_imagesinteger
  • seedinteger

    Seed for reproducible generation

  • enable_safety_checkerboolean

    Enable safety checker to filter inappropriate content

  • output_formatenum

    Output image format

    jpegpngwebp
generate_music

Генерируйте музыку по текстовым описаниям. Используйте list_models с category='audio', чтобы найти доступные модели.

Генерируйте музыку по текстовым описаниям. Используйте list_models с category='audio', чтобы найти доступные модели.

Параметры

  • promptstringобязательный

    Description of the music (genre, mood, instruments)

  • modelstring

    Model ID (e.g., 'fal-ai/lyria2', 'fal-ai/stable-audio-25/text-to-audio'). Use list_models to see options.

  • duration_secondsinteger

    Duration in seconds

  • negative_promptstring

    What to avoid in the audio (e.g., 'vocals, distortion, noise')

  • lyrics_promptstring

    Lyrics for vocal music generation. Only used with models that support lyrics (e.g., MiniMax). Format: [verse]\nLyric line 1\n[chorus]\nChorus line

generate_video

Создавайте видео по текстовым запросам (text-to-video) или по изображениям (image-to-video). Используйте list_models с параметром category='video', чтобы узнать доступные модели.

Создавайте видео по текстовым запросам (text-to-video) или по изображениям (image-to-video). Используйте list_models с параметром category='video', чтобы узнать доступные модели.

Параметры

  • promptstringобязательный

    Text description for the video (e.g., 'A slow-motion drone shot of Tokyo at night')

  • image_urlstring

    Starting image URL for image-to-video models. Optional for text-to-video models.

  • modelstring

    Model ID. Use 'fal-ai/kling-video/v2/master/text-to-video' for text-only, or image-to-video models like 'fal-ai/wan-i2v'.

  • durationinteger

    Video duration in seconds

  • aspect_ratiostring

    Video aspect ratio (e.g., '16:9', '9:16', '1:1')

  • negative_promptstring

    What to avoid in the video (e.g., 'blur, distort, low quality')

  • cfg_scalenumber

    Classifier-free guidance scale (0.0-1.0). Lower values give more creative results.

generate_video_from_image

Анимируйте изображение в видео. Изображение служит начальным кадром, а промпт управляет анимацией. Сначала используйте upload_file, если у вас есть локальное изображение.

Анимируйте изображение в видео. Изображение служит начальным кадром, а промпт управляет анимацией. Сначала используйте upload_file, если у вас есть локальное изображение.

Параметры

  • image_urlstringобязательный

    URL of the image to animate (use upload_file for local images)

  • promptstringобязательный

    Text description guiding how to animate the image (e.g., 'camera slowly pans right, gentle breeze moves the leaves')

  • modelstring

    Image-to-video model. Options: fal-ai/wan-i2v, fal-ai/kling-video/v2.1/standard/image-to-video

  • durationinteger

    Video duration in seconds

  • aspect_ratiostring

    Video aspect ratio (e.g., '16:9', '9:16', '1:1')

  • negative_promptstring

    What to avoid in the video (e.g., 'blur, distort, low quality')

  • cfg_scalenumber

    Classifier-free guidance scale (0.0-1.0). Lower values give more creative results.

generate_video_from_video

Преобразуйте существующее видео с помощью ИИ. Поддерживает переработку стиля (модели Lucy) и перенос движения (управление движением Kling). Сначала используйте upload_file, если у вас есть локальное видео.

Преобразуйте существующее видео с помощью ИИ. Поддерживает переработку стиля (модели Lucy) и перенос движения (управление движением Kling). Сначала используйте upload_file, если у вас есть локальное видео.

Параметры

  • video_urlstringобязательный

    URL of the source video to transform (use upload_file for local videos)

  • promptstringобязательный

    Text description of the transformation (e.g., 'transform into anime style', 'a woman dancing gracefully')

  • modelstring

    Video-to-video model. Options: decart/lucy-edit/dev (restyle), decart/lucy-edit/pro, decart/lucy-restyle, fal-ai/kling-video/v2.6/standard/motion-control (motion transfer), fal-ai/kling-video/v2.6/pro/motion-control

  • durationenum

    Duration of generated video in seconds

    510
  • aspect_ratioenum

    Aspect ratio of the generated video

    16:99:161:1
  • cfg_scalenumber

    Classifier Free Guidance scale - how closely to follow the prompt (0.0-1.0)

  • image_urlstring

    [Kling motion control] Reference image URL. The character in this image will be animated using motion from video_url.

  • character_orientationenum

    [Kling motion control] 'video': orientation matches reference video (max 30s). 'image': orientation matches reference image (max 10s).

    imagevideo
  • keep_original_soundboolean

    [Kling motion control] Whether to keep original sound from reference video.

  • tail_image_urlstring

    [Kling Pro] URL of image for the end of the video (for transitions).

  • generate_audioboolean

    [Kling v2.6 Pro] Generate native audio for video (supports Chinese/English).

  • negative_promptstring

    What to avoid in the output (default: 'blur, distort, and low quality')

  • strengthnumber

    [Lucy models] How much to transform (0=keep original, 1=full transformation)

  • num_framesinteger

    [Lucy models] Number of frames to process

get_pricing

Получает информацию о ценах на модели Fal.ai. Возвращает стоимость за единицу (изображение/видео/секунду) в USD. Используйте это, чтобы проверить стоимость перед генерацией контента.

Получает информацию о ценах на модели Fal.ai. Возвращает стоимость за единицу (изображение/видео/секунду) в USD. Используйте это, чтобы проверить стоимость перед генерацией контента.

Параметры

  • modelsstring[]обязательный

    Model IDs or aliases to get pricing for (e.g., ['flux_schnell', 'fal-ai/kling-video'])

get_usage

Получает историю использования и расходов для вашего рабочего пространства Fal.ai. Показывает количество, стоимость и разбивку по моделям. Требуется административный API-ключ.

Получает историю использования и расходов для вашего рабочего пространства Fal.ai. Показывает количество, стоимость и разбивку по моделям. Требуется административный API-ключ.

Параметры

  • startstring

    Start date (YYYY-MM-DD format). Defaults to 7 days ago.

  • endstring

    End date (YYYY-MM-DD format). Defaults to today.

  • modelsstring[]

    Filter by specific model IDs/aliases (optional)

inpaint_image

Редактируйте отдельные области изображения с помощью маски. Белые области маски будут регенерированы на основе промпта.

Редактируйте отдельные области изображения с помощью маски. Белые области маски будут регенерированы на основе промпта.

Параметры

  • image_urlstringобязательный

    URL of the source image (use upload_file for local images)

  • mask_urlstringобязательный

    URL of the mask image (white=edit, black=keep). Use upload_file for local masks.

  • promptstringобязательный

    What to generate in the masked area (e.g., 'a red sports car', 'green grass')

  • modelstring

    Inpainting model. Options: fal-ai/flux-kontext-lora/inpaint, fal-ai/flux-krea-lora/inpainting

  • negative_promptstring

    What to avoid in the generated area

  • seedinteger

    Seed for reproducible results

list_models

Находите доступные модели Fal.ai для генерации изображений, видео и аудио. Используйте параметр 'task' для интеллектуальной ранжировки по задачам (например, 'portrait photography') или 'search' для простой фильтрации по названию/описанию.

Находите доступные модели Fal.ai для генерации изображений, видео и аудио. Используйте параметр 'task' для интеллектуальной ранжировки по задачам (например, 'portrait photography') или 'search' для простой фильтрации по названию/описанию.

Параметры

  • categoryenum

    Filter by category (image, video, or audio)

    imagevideoaudio
  • taskstring

    Task description for intelligent ranking (e.g., 'anime illustration', 'product photography'). Uses Fal.ai's semantic search and prioritizes featured models.

  • searchstring

    Simple search query to filter models by name or description (e.g., 'flux'). Use 'task' for better semantic matching.

  • limitinteger

    Maximum number of models to return

recommend_model

Получайте рекомендации моделей на базе AI для конкретной задачи. Опишите, что вы хотите сделать (например, 'сгенерировать портретное фото', 'иллюстрация в стиле аниме', 'продуктовая фотография'), и получите наиболее подходящие модели, отсортированные по релевантности. Рекомендованные модели от Fal.ai имеют приоритет.

Получайте рекомендации моделей на базе AI для конкретной задачи. Опишите, что вы хотите сделать (например, 'сгенерировать портретное фото', 'иллюстрация в стиле аниме', 'продуктовая фотография'), и получите наиболее подходящие модели, отсортированные по релевантности. Рекомендованные модели от Fal.ai имеют приоритет.

Параметры

  • taskstringобязательный

    Description of your task (e.g., 'generate professional headshot', 'create anime character', 'transform photo to watercolor')

  • categoryenum

    Optional category hint to narrow search

    imagevideoaudio
  • limitinteger

    Maximum number of recommendations

remove_background

Удаляет фон с изображения, создавая прозрачный PNG. Отлично подходит для фотографий товаров, портретов и создания композиций.

Удаляет фон с изображения, создавая прозрачный PNG. Отлично подходит для фотографий товаров, портретов и создания композиций.

Параметры

  • image_urlstringобязательный

    URL of the image to remove background from (use upload_file for local images)

  • modelstring

    Background removal model. Options: fal-ai/birefnet/v2 (recommended), fal-ai/birefnet

  • output_formatenum

    Output format (PNG recommended for transparency)

    pngwebp
resize_image

Изменяет размер/формат изображений для разных платформ (как Canva Magic Resize). Использует AI outpainting для интеллектуального расширения контента под новые соотношения сторон. Примечание: режимы 'crop' и 'letterbox' скоро появятся.

Изменяет размер/формат изображений для разных платформ (как Canva Magic Resize). Использует AI outpainting для интеллектуального расширения контента под новые соотношения сторон. Примечание: режимы 'crop' и 'letterbox' скоро появятся.

Параметры

  • image_urlstringобязательный

    URL of the source image (use upload_file for local images)

  • target_formatenumобязательный

    Target platform format, or 'custom' to specify dimensions

    instagram_postinstagram_storyinstagram_reelyoutube_thumbnailyoutube_shorttwitter_posttwitter_headerlinkedin_postlinkedin_bannerfacebook_postfacebook_coverpinterest_pintiktokcustom
  • widthinteger

    Custom width in pixels (required if target_format='custom')

  • heightinteger

    Custom height in pixels (required if target_format='custom')

  • modeenum

    How to handle aspect ratio change: extend (AI outpainting - recommended), crop (coming soon), letterbox (coming soon)

    extendcropletterbox
  • background_promptstring

    For 'extend' mode: prompt to guide AI-generated extended areas (e.g., 'continue the beach scenery')

  • background_colorstring

    For 'letterbox' mode: hex color for bars (e.g., '#FFFFFF' for white)

upload_file

Загружает локальный файл в хранилище Fal.ai и возвращает URL. Используйте это для загрузки изображений, видео или аудиофайлов, которые затем можно применять с другими инструментами Fal.ai (например, image-to-video, audio transform).

Загружает локальный файл в хранилище Fal.ai и возвращает URL. Используйте это для загрузки изображений, видео или аудиофайлов, которые затем можно применять с другими инструментами Fal.ai (например, image-to-video, audio transform).

Параметры

  • file_pathstringобязательный

    Absolute path to the local file to upload (e.g., '/path/to/image.png')

upscale_image

Повышает разрешение изображения с сохранением качества. Используется для улучшения изображений с низким разрешением.

Повышает разрешение изображения с сохранением качества. Используется для улучшения изображений с низким разрешением.

Параметры

  • image_urlstringобязательный

    URL of the image to upscale (use upload_file for local images)

  • scaleenum

    Upscale factor (2x or 4x)

    24
  • modelstring

    Upscaling model. Options: fal-ai/clarity-upscaler (high quality), fal-ai/aura-sr (fast)

Другие проверенные MCP-сервера

Aas-ee/open-webSearch

Aas-ee/open-webSearch

open-websearch — это MCP-сервер и CLI для веб-поиска и извлечения контента без API-ключей. Поддерживает множество поисковиков (Bing, Baidu, DuckDuckGo и др.), загружает статьи и README с GitHub. Ра...

TypeScript1615
alchemy/alchemy-mcp-server

alchemy/alchemy-mcp-server

официальный

MCP-сервер для AI-агентов, работающий с блокчейн-данными Alchemy. Позволяет запрашивать цены токенов, NFT, историю транзакций и балансы на нескольких сетях, а также отправлять транзакции и выполнят...

TypeScript88
benborla29/mcp-server-mysql

benborla29/mcp-server-mysql

MCP сервер для работы с MySQL: инспектируйте схемы, выполняйте запросы и опционально записывайте данные прямо из Claude и других LLM. Предусмотрена защита PII, SSH-туннели и режим работы с несколькими базами. Полезен разработчикам и аналитикам.

JavaScript1959
higress-group/higress-ops-mcp-server

higress-group/higress-ops-mcp-server

официальный

Higress OPS MCP сервер управляет конфигурацией и мониторингом API-шлюза Higress через агентный поток на LangGraph. Помогает DevOps-инженерам автоматизировать работу с Higress Console API.

Python23
OctoMind-dev/octomind-mcp

OctoMind-dev/octomind-mcp

официальный

MCP сервер для платформы Octomind: управляйте e2e тестами прямо из локальной среды. Создавайте тест-кейсы по описанию, запускайте тесты и управляйте окружениями. Получайте отчёты. Полезен разработчикам и QA для интеграции автоматизированного тестирования.

TypeScript24
makenotion/notion-mcp-server

makenotion/notion-mcp-server

официальный

Notion MCP сервер даёт AI-агентам прямой доступ к Notion через API: читайте и редактируйте страницы в Markdown, делайте запросы к данным. Разработчики используют этот MCP инструмент для интеграции помощников с заметками и проектами, экономя токены.

TypeScript4540
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин