replicate-flux-mcp

replicate-flux-mcp — MCP-сервер сообщества (автор — awkoy). Генерация изображений через Replicate API. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
awkoy
Лицензия
MIT
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
typescript

Уровень риска: medium

Токен Replicate; каждая генерация — запуск в вашем аккаунте Replicate; run_replicate_model без белого списка запускает любую модель.

Настройка клиентов

codex
{
    "code": "[mcp_servers.replicate]\ncommand = \"npx\"\nargs = [\"-y\", \"replicate-flux-mcp\"]\nenv = { REPLICATE_API_TOKEN = \"your-replicate-api-token\", REPLICATE_IMAGE_MODEL_ID = \"your-image-model-id\", REPLICATE_SVG_MODEL_ID = \"your-svg-model-id\" }\nstartup_timeout_sec = 30_000",
    "file": "~/.codex/config.toml",
    "lang": "toml",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Replicate Flux MCP — MCP-сервер, который даёт ассистенту генерировать изображения и векторную графику через Replicate. По умолчанию растровые изображения создаёт модель black-forest-labs/flux-schnell, SVG — recraft-ai/recraft-v3-svg. Нужен токен Replicate API. Лицензия MIT.

Инструменты:

  • generate_image — изображение по текстовому описанию: seed, разрешение 1 или 0,25 мегапикселя, от 1 до 4 картинок, соотношение сторон, формат webp, jpg или png, качество, число шагов, отключение фильтра безопасности.
  • generate_multiple_images — от 1 до 10 изображений по массиву описаний.
  • generate_image_variants — от 2 до 10 вариантов одного описания: через seed (каждый вариант получает seed плюс номер) или через модификаторы стиля в режимах append и replace.
  • generate_svg — векторная графика с размером (по умолчанию 1024x1024) и стилями engraving, line_art, line_circuit, linocut.
  • prediction_list и get_prediction — история запусков Replicate и детали одного запуска.
  • run_model — запуск модели из белого списка с произвольными входными данными (видео, восстановление изображений).
  • run_replicate_model — запуск любой модели Replicate по ссылке owner/name[:version]; get_model_schema заранее показывает схему её входных параметров.

Ресурсы и шаблоны. Ресурсы imagelist, svglist и predictionlist показывают историю генераций. Пять готовых шаблонов — logo, portrait, svg-icon, product-shot, isometric-diagram — появляются в меню команд Claude Desktop и в палитре Cursor.

Белые списки моделей. Для изображений: flux-schnell, google/imagen-4, flux-kontext-pro, ideogram-v3-turbo, flux-1.1-pro, flux-dev; для SVG — recraft-v3-svg. Переменная REPLICATE_MODEL_ALLOWLIST ограничивает модели для run_replicate_model: не задана — разрешены любые, задана пустой — запрещены все.

Все инструменты generate_* возвращают и обычный ответ, и структурированный structuredContent; пакетная генерация присылает уведомления о прогрессе.

Кому подойдёт

  • Дизайнерам и маркетологам — логотипы, иконки, продуктовые снимки.
  • Разработчикам, которым нужны картинки и SVG прямо из редактора.

Похожие серверы — в категории медиа и творчество.

Установка

Зарегистрируйтесь на Replicate и создайте токен API в настройках аккаунта. Сервер запускается через npx -y replicate-flux-mcp с переменной REPLICATE_API_TOKEN. Модели меняются без правки кода переменными REPLICATE_IMAGE_MODEL_ID и REPLICATE_SVG_MODEL_ID (только из белых списков). Есть и размещённые варианты на Smithery и Glama.ai.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "replicate-flux-mcp": {
      "command": "env REPLICATE_API_TOKEN=YOUR_TOKEN npx",
      "args": ["-y", "replicate-flux-mcp"]
    }
  }
}

В Cursor файл — .cursor/mcp.json в папке проекта, в Codex — ~/.codex/config.toml. После правки перезапустите клиент.

Проверка

Попросите: «Сгенерируй изображение горного озера на закате» — сработает generate_image.

Примеры задач

Сделай четыре варианта портрета персонажа: аниме, акварель, масло и 3D.
Нарисуй SVG-иконку облака в стиле line_art.

Риски

  • Токен Replicate. Храните его в переменной окружения и не публикуйте.
  • Запуски в вашем аккаунте. Каждая генерация создаёт запуск (prediction) в аккаунте Replicate — он виден в predictionlist; пакетная генерация и варианты создают по несколько изображений за раз.
  • Произвольные модели. run_replicate_model по умолчанию запускает любую модель — ограничьте её через REPLICATE_MODEL_ALLOWLIST.
  • Фильтр безопасности можно отключить параметром disable_safety_checker.

Частые вопросы

Какие модели используются по умолчанию?

Flux Schnell для изображений и Recraft V3 SVG для векторной графики.

Что делать при ошибке таймаута?

README советует увеличить pollingAttempts или pollingInterval в конфигурации.

Почему запрос отклонён?

Встроенный фильтр безопасности модели мог заблокировать описание — переформулируйте его.

Основы протокола — на странице что такое MCP-сервер.

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

FunASR

Локальная расшифровка аудио моделями FunASR и SenseVoice.

Риск: medium Лицензия: MIT ★ 20 999

OpenScreen

Запись экрана и видеоредактор: агенты записывают, обрезают, масштабируют, добавляют субтитры и экспортируют видео.

Риск: medium Лицензия: MIT ★ 7 025

ffmpeg-skill

Локальные инструменты FFmpeg для видео и аудио.

Риск: medium Лицензия: MIT ★ 4 730

davinci-resolve-mcp

Интеграция с DaVinci Resolve: монтаж, цветокоррекция, медиа и проекты.

Риск: medium Лицензия: MIT ★ 4 003

Источники