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 для точного позиционирования - без ИИ.

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

    URL фонового/базового изображения

  • opacitynumber

    Непрозрачность оверлея (0.0 = прозрачный, 1.0 = непрозрачный)

  • output_formatenum

    Формат выходного изображения

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

    URL изображения для наложения (например, логотип, водяной знак). Для локальных изображений используйте upload_file.

  • paddinginteger

    边缘内边距(像素)(适用于预设位置)

  • positionenum

    Где разместить оверлей. Используйте 'custom' с координатами x,y для точного позиционирования.

  • scalenumber

    Масштабирует наложение относительно ширины базового изображения (0.01-1.0). По умолчанию 0.15 = 15% от ширины базового изображения.

  • xinteger

    Своя позиция X в пикселях (обязательно, если position='custom')

  • yinteger

    Пользовательская позиция по оси Y в пикселях (обязательно, если position='custom')

edit_image

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

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

    URL изображения, которое нужно отредактировать (для локальных изображений используйте upload_file).

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

    Описание правки на естественном языке (например, «сделай небо более драматичным», «измени цвет машины на красный»)

  • modelstring

    Модель редактирования. Варианты: fal-ai/flux-2/edit, fal-ai/flux-2-pro/edit (более высокое качество)

  • seedinteger

    Зерно для воспроизводимых правок

  • strengthnumber

    Это параметр степени изменения изображения. Значение 0 означает минимальные изменения (сохраняем почти всё как есть), значение 1 — максимальные (сильно меняем картинку по запросу). Обычно используется в инструментах редактирования изображений, где нужно указать, насколько сильно модель должна отходить от исходного изображения при внесении изменений. Конкретная семантика зависит от инструмента, но общий принцип такой: - 0 — почти не трогаем оригинал, вносим точечные правки - 0.5 — умеренные изменения, баланс между оригиналом и запросом - 1 — максимально переделываем изображение под запрос, оригинал служит лишь отправной точкой Если вы используете какой-то конкретный API или сервис, уточните, о каком именно инструменте речь — тогда смогу дать более точный ответ.

generate_image

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

Параметры
  • enable_safety_checkerboolean

    Включает проверку безопасности для фильтрации нежелательного контента.

  • image_sizeenum
  • modelstring

    Идентификатор модели (например, 'fal-ai/flux-pro') или псевдоним (например, 'flux_schnell'). Используйте list_models для просмотра вариантов.

  • negative_promptstring

    Вы уточните, пожалуйста, о каком именно изображении идёт речь? В контексте нашего предыдущего разговора (перевод описания инструмента) вы, возможно, имеете в виду: 1. Если речь о скриншоте или иллюстрации для документации — избегайте: - Размытости, низкого разрешения, артефактов сжатия. - Лишних элементов интерфейса (панелей, вкладок, уведомлений), не относящихся к делу. - Текста с ошибками или опечатками (особенно если на изображении есть код или термины). - Водяных знаков, логотипов сторонних сервисов, если они не нужны. - Слишком мелкого шрифта, который невозможно прочитать. - Искажения пропорций или обрезки важных деталей. 2. Если речь о правилах перевода для изображений (например, для локализации) — избегайте: - Дословного перевода, который ломает смысл. - Игнорирования контекста (кнопки, подписи, диалоговые окна). - Потери форматирования (например, если на картинке текст в одну строку, а перевод не влезает). 3. Если речь о генерации изображений (AI) — избегайте: - Лишних пальцев на руках, неестественных поз, асимметрии лиц. - Неправильного текста на картинке (AI часто пишет бессмыслицу). - Смешения стилей, если нужен единый стиль. - Слишком большого количества объектов, отвлекающих от главного. Если вы имели в виду что-то другое (например, что избегать при создании логотипа или фото), уточните — я дам точный ответ.

  • num_imagesinteger
  • output_formatenum

    Формат выходного изображения

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

    Текстовое описание изображения для генерации

  • seedinteger

    Сид для воспроизводимой генерации

generate_image_from_image

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

Параметры
  • enable_safety_checkerboolean

    Включает проверку безопасности для фильтрации нежелательного контента.

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

    URL исходного изображения для преобразования (используйте upload_file для локальных изображений)

  • modelstring

    Модель image-to-image. Варианты: fal-ai/flux/dev/image-to-image, fal-ai/flux-2/edit

  • negative_promptstring

    Чего следует избегать в выходном изображении

  • num_imagesinteger
  • output_formatenum

    Формат выходного изображения

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

    Текстовое описание желаемого преобразования (например, «Преобразовать в акварельную живопись»)

  • seedinteger

    Сид для воспроизводимой генерации

  • strengthnumber

    Насколько преобразовывать (0=сохранить оригинал, 1=игнорировать оригинал)

generate_image_structured

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

Параметры
  • backgroundstring

    Описание фона.

  • cameraobject

    Настройки камеры для управления фотографическим стилем.

  • color_palettestring[]

    Шестнадцатеричные коды цветов для палитры (например, ['#000033', '#6A0DAD', '#FFFFFF'])

  • compositionstring

    Правила композиции (например, «правило третей», «центрирование», «золотое сечение»)

  • effectsstring[]

    Визуальные эффекты (например, ['Боке', 'Световые лучи', 'Блик объектива', 'Размытие движения'])

  • enable_safety_checkerboolean

    Включает проверку безопасности для фильтрации нежелательного контента.

  • image_sizeenum
  • lightingstring

    Описание освещения (например, «Мягкий свет золотого часа», «Драматичная светотень»)

  • modelstring

    ID модели или псевдоним. Используйте list_models, чтобы посмотреть варианты.

  • moodstring

    Эмоциональное настроение изображения (например, «Спокойное», «Драматичное», «Загадочное»)

  • negative_promptstring

    Чего следует избегать на изображении (например, 'размытое, низкое качество, искажённое')

  • num_imagesinteger
  • output_formatenum

    Формат выходного изображения

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

    Общее описание сцены - основной объект и обстановка

  • seedinteger

    Сид для воспроизводимой генерации

  • stylestring

    Художественный стиль (например, 'Цифровая живопись', 'Фотореализм', 'Акварель', 'Масляная живопись')

  • subjectsobject[]

    Список тем с их позициями и описаниями.

generate_music

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

Параметры
  • duration_secondsinteger

    Продолжительность в секундах

  • lyrics_promptstring

    Текст для генерации вокальной музыки. Используется только с моделями, поддерживающими тексты песен (например, MiniMax). Формат: [verse]\nСтрока куплета 1\n[chorus]\nСтрока припева

  • modelstring

    Идентификатор модели (например, 'fal-ai/lyria2', 'fal-ai/stable-audio-25/text-to-audio'). Используйте list_models, чтобы увидеть варианты.

  • negative_promptstring

    Чего избегать в аудио (например, «вокал, искажения, шум»).

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

    Описание музыки (жанр, настроение, инструменты)

generate_video

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

Параметры
  • aspect_ratiostring

    Соотношение сторон видео (например, '16:9', '9:16', '1:1')

  • cfg_scalenumber

    Шкала бесклассового управления (0.0-1.0). Меньшие значения дают более творческие результаты.

  • durationinteger

    Продолжительность видео в секундах

  • image_urlstring

    Начальный URL изображения для моделей «изображение-в-видео». Необязателен для моделей «текст-в-видео».

  • modelstring

    Идентификатор модели. Используйте 'fal-ai/kling-video/v2/master/text-to-video' для текстовых запросов или модели изображение-в-видео, такие как 'fal-ai/wan-i2v'.

  • negative_promptstring

    Чего избегать в видео (например, размытие, искажение, низкое качество)

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

    Текстовое описание для видео (например, «Замедленная съемка с дрона Токио ночью»)

generate_video_from_image

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

Параметры
  • aspect_ratiostring

    Соотношение сторон видео (например, '16:9', '9:16', '1:1')

  • cfg_scalenumber

    Шкала бесклассового управления (0.0-1.0). Меньшие значения дают более творческие результаты.

  • durationinteger

    Продолжительность видео в секундах

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

    URL изображения для анимации (используйте upload_file для локальных изображений)

  • modelstring

    Модель преобразования изображения в видео. Варианты: fal-ai/wan-i2v, fal-ai/kling-video/v2.1/standard/image-to-video

  • negative_promptstring

    Чего избегать в видео (например, размытие, искажение, низкое качество)

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

    Текстовое описание, направляющее анимацию изображения (например, «камера медленно панорамирует вправо, лёгкий ветерок колышет листья»)

generate_video_from_video

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

Параметры
  • aspect_ratioenum

    Соотношение сторон сгенерированного видео

  • cfg_scalenumber

    Шкала Classifier Free Guidance - насколько точно следовать промпту (0.0–1.0).

  • character_orientationenum

    [Управление движением Kling] 'video': ориентация соответствует эталонному видео (макс. 30 секунд). 'image': ориентация соответствует эталонному изображению (макс. 10 секунд).

  • durationenum

    Длительность сгенерированного видео в секундах

  • generate_audioboolean

    [Kling v2.6 Pro] Создаёт нативное аудио для видео (поддерживает китайский/английский).

  • image_urlstring

    Управление движением Kling. URL опорного изображения. Персонаж на этом изображении будет анимирован с использованием движения из video_url.

  • keep_original_soundboolean

    [Kling motion control] 是否保留参考视频中的原始声音。

  • modelstring

    Модель видео-в-видео. Варианты: decart/lucy-edit/dev (рестайлинг), decart/lucy-edit/pro, decart/lucy-restyle, fal-ai/kling-video/v2.6/standard/motion-control (перенос движения), fal-ai/kling-video/v2.6/pro/motion-control

  • negative_promptstring

    Чего избегать в выводе (по умолчанию: «размытие, искажение и низкое качество»)

  • num_framesinteger

    [Модели Lucy] Количество кадров для обработки.

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

    Текстовое описание трансформации (например, «преобразовать в стиль аниме», «женщина, грациозно танцующая»)

  • strengthnumber

    [Модели Lucy] Насколько преобразовать (0=сохранить оригинал, 1=полное преобразование)

  • tail_image_urlstring

    [Kling Pro] URL изображения для конца видео (для переходов).

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

    URL исходного видео для преобразования (для локальных видео используйте upload_file)

get_pricing

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

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

    Идентификаторы моделей или псевдонимы для получения цен (например, ['flux_schnell', 'fal-ai/kling-video'])

get_usage

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

Параметры
  • endstring

    Дата окончания (формат ГГГГ-ММ-ДД). По умолчанию — сегодня.

  • modelsstring[]

    Фильтр по конкретным ID/псевдонимам моделей (необязательно)

  • startstring

    Дата начала (формат YYYY-MM-DD). По умолчанию 7 дней назад.

inpaint_image

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

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

    URL исходного изображения (для локальных изображений используйте upload_file)

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

    URL изображения маски (белый = редактировать, черный = оставить). Используйте upload_file для локальных масок.

  • modelstring

    Модель инпейнтинга. Варианты: fal-ai/flux-kontext-lora/inpaint, fal-ai/flux-krea-lora/inpainting

  • negative_promptstring

    В переводе нужно избегать: - Длинного тире «—» (заменять на дефис, запятую, двоеточие или точку). - Канцелярита и штампов: «данный», «является», «представляет собой», «стоит отметить», «важно понимать», «в современном мире», «играет ключевую роль», «позволяет осуществить», «обеспечивает возможность». - Оборотов «не просто X, а Y» и «не только X, но и Y». - Формульных выводов: «таким образом», «подводя итог». - Раздувания значимости: «мощный инструмент», «открывает новые горизонты», «выводит на новый уровень». - Модального хеджирования: «может стать», «способен обеспечить», «призван решить». - Отглагольных существительных там, где нужен глагол (например, «осуществление оптимизации» → «ускоряет»). - Длинных вступлений и абстрактных формулировок. Нужно сразу к делу, конкретные действия, активный залог, живой, но не панибратский тон.

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

    Что генерировать в замаскированной области (например, «красный спортивный автомобиль», «зелёная трава»)

  • seedinteger

    Зерно для воспроизводимых результатов

list_models

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

Параметры
  • categoryenum

    Фильтр по категории (изображение, видео или аудио)

  • limitinteger

    Максимальное количество моделей для возврата

  • searchstring

    Простой поисковый запрос для фильтрации моделей по имени или описанию (например, 'flux'). Используйте 'task' для более точного семантического сопоставления.

  • taskstring

    Описание задачи для интеллектуального ранжирования (например, 'аниме-иллюстрация', 'предметная фотография'). Использует семантический поиск Fal.ai и отдает приоритет рекомендуемым моделям.

recommend_model

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

Параметры
  • categoryenum

    Необязательная подсказка по категории для сужения поиска

  • limitinteger

    Максимальное количество рекомендаций

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

    Описание вашей задачи (например, «сгенерировать профессиональный портрет», «создать аниме-персонажа», «преобразовать фото в акварель»)

remove_background

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

Параметры
  • image_urlstringобязательный
  • modelstring

    Модель удаления фона. Варианты: fal-ai/birefnet/v2 (рекомендуется), fal-ai/birefnet

  • output_formatenum

    Формат вывода (рекомендуется PNG для прозрачности)

resize_image

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

Параметры
  • background_colorstring

    Для режима «letterbox»: hex-цвет для полос (например, '#FFFFFF' для белого).

  • background_promptstring

    Для режима 'extend': подсказка для управления областями, расширенными ИИ (например, 'продолжить пляжный пейзаж')

  • heightinteger

    Пользовательская высота в пикселях (требуется, если target_format='custom')

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

    URL исходного изображения (для локальных изображений используйте upload_file)

  • modeenum

    Как обрабатывать изменение соотношения сторон: расширение (AI outpainting - рекомендуется), обрезка (скоро), letterbox (скоро)

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

    Целевой формат платформы, или «custom» для указания размеров

  • widthinteger

    Произвольная ширина в пикселях (обязательно, если target_format='custom')

upload_file

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

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

    Абсолютный путь к локальному файлу для загрузки (например, '/path/to/image.png')

upscale_image

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

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

    URL изображения для увеличения разрешения (используйте upload_file для локальных изображений)

  • modelstring

    Модель апскейлинга. Варианты: fal-ai/clarity-upscaler (высокое качество), fal-ai/aura-sr (быстрый)

  • scaleenum

    Коэффициент увеличения (2x или 4x)

Похожие MCP-сервера

AetherWave-Studio/aetherwave-mcp

AetherWave-Studio/aetherwave-mcp

MCP сервер AetherWave Studio объединяет 16+ инструментов генерации контента: изображения, видео, музыка, мастеринг. Один API-ключ и пул кредитов дают доступ к Suno, Grok, Midjourney, Topaz. Интегри...

JavaScript6
skyworkai/mureka-mcp

skyworkai/mureka-mcp

Mureka MCP сервер даёт ИИ-агентам (Claude Desktop, OpenAI Agents) возможность генерировать тексты, песни и фоновую музыку (инструментал). Полезен музыкантам и разработчикам для автоматизации создания аудиоконтента.

Python113
jau123/MeiGen-AI-Design-MCP

jau123/MeiGen-AI-Design-MCP

MCP-сервер для генерации изображений и видео через ИИ. Работает в Claude Code, Cursor и других AI-инструментах, поддерживает 9 моделей и 1446 промптов. Параллельная генерация, управление стилями и ...

TypeScript1747
doctorm333/promptpilot-mcp-server

doctorm333/promptpilot-mcp-server

PromptPilot MCP-сервер генерирует изображения, видео и аудио прямо в Claude, Cursor или Windsurf. Поддерживает 20+ моделей (Flux, Imagen 4, Grok Imagine и др.), есть бесплатные без ключа. Полезен р...

JavaScript2
runapi-ai/mcp

runapi-ai/mcp

официальный

RunAPI MCP Server открывает 130+ моделей генерации медиа, музыки, речи и поиска промптов прямо из MCP-хостов — Claude Code, Cursor, VS Code. Идеально для быстрых экспериментов с генерацией без пере...

TypeScript55
stabgan/openrouter-mcp-multimodal

stabgan/openrouter-mcp-multimodal

Мультимодальный MCP-сервер для анализа и генерации текста, изображений, аудио и видео. Интегрируется с Claude Desktop, Cursor и другими клиентами через OpenRouter, давая доступ к 300+ моделям. Вклю...

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

Лука Никитин