репликация-поток-mcp

Повторный поток MCP

Совместимость с MCP Лицензия Машинопись Модель контекстного протокола Загрузки НПМ Звезды

Replicate Flux MCP — это усовершенствованный сервер Model Context Protocol (MCP), который позволяет помощникам ИИ создавать высококачественные изображения и векторную графику. Использование модели Flux Schnell от Black Forest Labs для растровых изображений и модели V3 SVG от Recraft для векторной графики через API Replicate.

📑 Содержание

Начало работы и интеграция
Функции
Документация
- Доступные инструменты
- Доступные ресурсы
Разработка
Технические подробности
Поиск неисправностей
Внося вклад
Лицензия
Ресурсы
Примеры

🚀 Начало работы и интеграция

Процесс установки

Получите токен API Replicate
- Зарегистрируйтесь на Replicate
- Создайте API-токен в настройках вашего аккаунта.
Выберите метод интеграции
- Воспользуйтесь одним из вариантов интеграции ниже в зависимости от предпочитаемого вами клиента MCP.
Попросите вашего помощника на основе искусственного интеллекта сгенерировать изображение
- Просто спросите: «Можете ли вы создать изображение спокойного горного пейзажа на закате?»
- Или конкретнее: «Пожалуйста, создайте изображение, показывающее мирный горный пейзаж с озером, отражающим цвета заката на переднем плане».
Изучите расширенные функции
- Попробуйте разные настройки параметров для получения индивидуальных результатов
- Эксперимент с генерацией SVG с помощью generate_svg
- Используйте функции пакетной генерации изображений или генерации вариантов

Интеграция курсора

Метод 1: Использование mcp.json

Создайте или отредактируйте файл .cursor/mcp.json в каталоге вашего проекта:

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

Замените YOUR_TOKEN на ваш фактический токен API Replicate.
Перезапустите курсор, чтобы применить изменения.

Метод 2: Ручной режим

Откройте Курсор и перейдите в Настройки.
Перейдите в раздел «MCP» или «Model Context Protocol».
Нажмите «Добавить сервер» или эквивалентную кнопку.
Введите следующую команду в соответствующее поле:

env REPLICATE_API_TOKEN=YOUR_TOKEN npx -y replicate-flux-mcp

Замените YOUR_TOKEN на ваш фактический токен API Replicate.
Сохраните настройки и перезапустите Курсор при необходимости.

Интеграция рабочего стола Клода

Создайте или отредактируйте файл mcp.json в каталоге конфигурации:

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

Замените YOUR_TOKEN на ваш фактический токен API Replicate.
Перезапустите Claude Desktop, чтобы изменения вступили в силу.

Интеграция кузнечного дела

Этот сервер MCP доступен в качестве размещенной службы на Smithery, что позволяет вам использовать его без настройки собственного сервера.

Посетите Smithery и создайте учетную запись, если у вас ее нет.
Перейдите на страницу сервера Replicate Flux MCP.
Нажмите «Добавить в рабочее пространство», чтобы добавить сервер в рабочее пространство Smithery.
Настройте свой клиент MCP (Cursor, Claude Desktop и т. д.) для использования URL-адреса вашего рабочего пространства Smithery.

Дополнительную информацию об использовании Smithery с клиентами MCP можно найти в документации Smithery .

Интеграция Glama.ai

Этот сервер MCP также доступен в качестве размещенного сервиса на Glama.ai, что обеспечивает еще одну возможность его использования без локальной настройки.

Посетите Glama.ai и создайте учетную запись, если у вас ее нет.
Перейти на страницу сервера Replicate Flux MCP
Нажмите «Установить сервер», чтобы добавить сервер в свое рабочее пространство.
Настройте клиент MCP для использования рабочего пространства Glama.ai

Для получения дополнительной информации посетите документацию по серверам Glama.ai MCP .

🌟 Особенности

🖼️ Генерация высококачественных изображений — создавайте потрясающие изображения с помощью Flux Schnell, современной модели искусственного интеллекта.
🎨 Поддержка векторной графики — создавайте профессиональную векторную графику SVG с помощью модели Recraft V3 SVG
🤖 Интеграция помощника на основе искусственного интеллекта — легко подключайте помощников на основе искусственного интеллекта, таких как Клод, для создания визуального контента
🎛️ Расширенная настройка — тонкая настройка генерации с помощью элементов управления соотношением сторон, качеством, разрешением и т. д.
🔌 Универсальная совместимость с MCP — работает со всеми клиентами MCP, включая Cursor, Claude Desktop, Cline и Zed
🔒 Безопасная локальная обработка — все запросы обрабатываются локально для повышения конфиденциальности и безопасности.
🔍 Комплексное управление историей — отслеживайте, просматривайте и извлекайте полную историю поколений
📊 Пакетная обработка — создание нескольких изображений из разных запросов в одном запросе
🔄 Исследование вариантов — создание и сравнение нескольких интерпретаций одной и той же концепции.
✏️ Инжиниринг подсказок — тонкая настройка вариаций изображений с помощью специализированных модификаций подсказок

📚 Документация

Доступные инструменты

`generate_image`

Генерирует изображение на основе текстовой подсказки с использованием модели Flux Schnell.

{
  prompt: string;                // Required: Text description of the image to generate
  seed?: number;                 // Optional: Random seed for reproducible generation
  go_fast?: boolean;             // Optional: Run faster predictions with optimized model (default: true)
  megapixels?: "1" | "0.25";     // Optional: Image resolution (default: "1")
  num_outputs?: number;          // Optional: Number of images to generate (1-4) (default: 1)
  aspect_ratio?: string;         // Optional: Aspect ratio (e.g., "16:9", "4:3") (default: "1:1")
  output_format?: string;        // Optional: Output format ("webp", "jpg", "png") (default: "webp")
  output_quality?: number;       // Optional: Image quality (0-100) (default: 80)
  num_inference_steps?: number;  // Optional: Number of denoising steps (1-4) (default: 4)
  disable_safety_checker?: boolean; // Optional: Disable safety filter (default: false)
}

`generate_multiple_images`

Генерирует несколько изображений на основе массива подсказок с использованием модели Flux Schnell.

{
  prompts: string[];             // Required: Array of text descriptions for images to generate (1-10 prompts)
  seed?: number;                 // Optional: Random seed for reproducible generation
  go_fast?: boolean;             // Optional: Run faster predictions with optimized model (default: true)
  megapixels?: "1" | "0.25";     // Optional: Image resolution (default: "1")
  aspect_ratio?: string;         // Optional: Aspect ratio (e.g., "16:9", "4:3") (default: "1:1")
  output_format?: string;        // Optional: Output format ("webp", "jpg", "png") (default: "webp")
  output_quality?: number;       // Optional: Image quality (0-100) (default: 80)
  num_inference_steps?: number;  // Optional: Number of denoising steps (1-4) (default: 4)
  disable_safety_checker?: boolean; // Optional: Disable safety filter (default: false)
}

`generate_image_variants`

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

{
  prompt: string;                // Required: Text description for the image to generate variants of
  num_variants: number;          // Required: Number of image variants to generate (2-10, default: 4)
  prompt_variations?: string[];  // Optional: List of prompt modifiers to apply to variants (e.g., ["in watercolor style", "in oil painting style"])
  variation_mode?: "append" | "replace"; // Optional: How to apply variations - 'append' adds to base prompt, 'replace' uses variations directly (default: "append")
  seed?: number;                 // Optional: Base random seed. Each variant will use seed+variant_index
  go_fast?: boolean;             // Optional: Run faster predictions with optimized model (default: true)
  megapixels?: "1" | "0.25";     // Optional: Image resolution (default: "1")
  aspect_ratio?: string;         // Optional: Aspect ratio (e.g., "16:9", "4:3") (default: "1:1")
  output_format?: string;        // Optional: Output format ("webp", "jpg", "png") (default: "webp")
  output_quality?: number;       // Optional: Image quality (0-100) (default: 80)
  num_inference_steps?: number;  // Optional: Number of denoising steps (1-4) (default: 4)
  disable_safety_checker?: boolean; // Optional: Disable safety filter (default: false)
}

`generate_svg`

Создает векторное изображение SVG на основе текстовой подсказки с использованием модели Recraft V3 SVG.

{
  prompt: string;                // Required: Text description of the SVG to generate
  size?: string;                 // Optional: Size of the generated SVG (default: "1024x1024")
  style?: string;                // Optional: Style of the generated image (default: "any")
                                // Options: "any", "engraving", "line_art", "line_circuit", "linocut"
}

`prediction_list`

Извлекает список ваших последних прогнозов из Replicate.

{
  limit?: number;  // Optional: Maximum number of predictions to return (1-100) (default: 50)
}

`get_prediction`

Получает подробную информацию о конкретном прогнозе.

{
  predictionId: string;  // Required: ID of the prediction to retrieve
}

Доступные ресурсы

`imagelist`

Просмотрите историю созданных изображений с помощью модели Flux Schnell.

`svglist`

Просмотрите историю созданных SVG-изображений с помощью модели Recraft V3 SVG.

`predictionlist`

Просмотрите всю историю ваших прогнозов Replicate.

💻 Развитие

Клонируйте репозиторий:

git clone https://github.com/awkoy/replicate-flux-mcp.git
cd replicate-flux-mcp

Установить зависимости:

npm install

Запустить режим разработки:

npm run dev

Создайте проект:

npm run build

Подключиться к клиенту:

{
  "mcpServers": {
    "image-generation-mcp": {
      "command": "npx",
      "args": [
        "/Users/{USERNAME}/{PATH_TO}/replicate-flux-mcp/build/index.js"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "YOUR REPLICATE API TOKEN"
      }
    }
  }
}

⚙️ Технические подробности

Куча

SDK Model Context Protocol — основные функции MCP для управления инструментами и ресурсами
API Replicate — обеспечивает доступ к современным моделям генерации изображений на основе искусственного интеллекта.
TypeScript — обеспечивает безопасность типов и использует современные возможности JavaScript.
Zod — реализует проверку типов во время выполнения для надежного взаимодействия API.

Конфигурация

Сервер можно настроить, изменив объект CONFIG в src/config/index.ts :

const CONFIG = {
  serverName: "replicate-flux-mcp",
  serverVersion: "0.1.2",
  imageModelId: "black-forest-labs/flux-schnell",
  svgModelId: "recraft-ai/recraft-v3-svg",
  pollingAttempts: 25,
  pollingInterval: 2000, // ms
};

🔍 Устранение неполадок

Общие проблемы

Ошибка аутентификации

Убедитесь, что ваш REPLICATE_API_TOKEN правильно настроен в среде
Проверьте действительность вашего токена, протестировав его напрямую с помощью API Replicate.

Сработал фильтр безопасности

Модель имеет встроенный фильтр безопасности, который может блокировать определенные подсказки.
Попробуйте изменить запрос, чтобы избежать потенциально проблемного контента.

Ошибка тайм-аута

Для больших изображений или загруженных серверов может потребоваться увеличить pollingAttempts или pollingInterval в конфигурации.
Настройки по умолчанию должны подходить для большинства случаев использования.

🤝 Вклад

Вклады приветствуются! Пожалуйста, выполните следующие шаги, чтобы внести вклад:

Форк репозитория
Создайте ветку функций ( git checkout -b feature/amazing-feature )
Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )
Отправить в ветку ( git push origin feature/amazing-feature )
Открыть запрос на извлечение

Для запросов функций или отчетов об ошибках, пожалуйста, создайте проблему на GitHub. Если вам нравится этот проект, рассмотрите возможность добавления репозитория в список звезд!

📄 Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

🔗 Ресурсы

🎨 Примеры

Демо

Несколько подсказок	Варианты подсказок

Вот несколько примеров использования инструментов:

Пакетная генерация изображений с помощью `generate_multiple_images`

Создавайте несколько отдельных изображений одновременно с разными подсказками:

{
  "prompts": [
    "A red sports car on a mountain road", 
    "A blue sports car on a beach", 
    "A vintage sports car in a city street"
  ]
}

Варианты изображений с `generate_image_variants`

Создайте различные интерпретации одной и той же концепции, используя семена:

{
  "prompt": "A futuristic city skyline at night",
  "num_variants": 4,
  "seed": 42
}

Или изучите вариации стиля с помощью модификаторов подсказок:

{
  "prompt": "A character portrait",
  "prompt_variations": [
    "in anime style", 
    "in watercolor style", 
    "in oil painting style", 
    "as a 3D render"
  ]
}

Сделано с ❤️ Ярославом Бойко

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

MCP для модели Replicate Flux. Генерация изображений по подсказкам

Related Resources

Reddit Discussion about this server

Related MCP Servers

Flux Image MCP Server
ckz
-
security
A
license
-
quality
Provides image generation capabilities using the Flux Schnell model on Replicate, allowing users to create images from text prompts.
Last updated -
1
JavaScript
MIT License
Flux Schnell MCP Server
ckz
-
security
-
license
-
quality
A server that enables generating images through the Replicate API by calling the Flux Schnell model via the Model Context Protocol (MCP).
Last updated -
3
JavaScript
MIT License
Image Generation MCP Server
GongRzhe
-
security
A
license
-
quality
Provides image generation capabilities for Claude using the Replicate Flux model, allowing users to create images from text prompts with customizable parameters like aspect ratio and output format.
Last updated -
145
19
JavaScript
MIT License
FLUX Image Generator MCP Server
frankdeno
A
security
F
license
A
quality
An MCP server that generates images based on text prompts using Black Forest Lab's FLUX model, allowing for customized image dimensions, prompt upsampling, safety settings, and batch generation.
Last updated -
3
TypeScript

View all related MCP servers

Повторный поток MCP

📑 Содержание

🚀 Начало работы и интеграция

Процесс установки

Интеграция курсора

Метод 1: Использование mcp.json

Метод 2: Ручной режим

Интеграция рабочего стола Клода

Интеграция кузнечного дела

Интеграция Glama.ai

🌟 Особенности

📚 Документация

Доступные инструменты

generate_image

generate_multiple_images

generate_image_variants

generate_svg

prediction_list

get_prediction