Skip to main content
Glama
deenesjakoruzh
awkoy

replicate-flux-mcp

by awkoy
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

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

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

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

📑 Содержание

Related MCP server: Image Generator MCP Server

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

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

  1. Получите токен API Replicate

    • Зарегистрируйтесь на Replicate

    • Создайте API-токен в настройках вашего аккаунта.

  2. Выберите метод интеграции

    • Воспользуйтесь одним из вариантов интеграции ниже в зависимости от предпочитаемого вами клиента MCP.

  3. Попросите вашего помощника на основе искусственного интеллекта сгенерировать изображение

    • Просто спросите: «Можете ли вы создать изображение спокойного горного пейзажа на закате?»

    • Или конкретнее: «Пожалуйста, создайте изображение, показывающее мирный горный пейзаж с озером, отражающим цвета заката на переднем плане».

  4. Изучите расширенные функции

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

    • Эксперимент с генерацией SVG с помощью generate_svg

    • Используйте функции пакетной генерации изображений или генерации вариантов

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

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

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

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

  1. Замените YOUR_TOKEN на ваш фактический токен API Replicate.

  2. Перезапустите курсор, чтобы применить изменения.

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

  1. Откройте Курсор и перейдите в Настройки.

  2. Перейдите в раздел «MCP» или «Model Context Protocol».

  3. Нажмите «Добавить сервер» или эквивалентную кнопку.

  4. Введите следующую команду в соответствующее поле:

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

  1. Замените YOUR_TOKEN на ваш фактический токен API Replicate.

  2. Сохраните настройки и перезапустите Курсор при необходимости.

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

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

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

  1. Замените YOUR_TOKEN на ваш фактический токен API Replicate.

  2. Перезапустите Claude Desktop, чтобы изменения вступили в силу.

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

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

  1. Посетите Smithery и создайте учетную запись, если у вас ее нет.

  2. Перейдите на страницу сервера Replicate Flux MCP.

  3. Нажмите «Добавить в рабочее пространство», чтобы добавить сервер в рабочее пространство Smithery.

  4. Настройте свой клиент MCP (Cursor, Claude Desktop и т. д.) для использования URL-адреса вашего рабочего пространства Smithery.

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

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

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

  1. Посетите Glama.ai и создайте учетную запись, если у вас ее нет.

  2. Перейти на страницу сервера Replicate Flux MCP

  3. Нажмите «Установить сервер», чтобы добавить сервер в свое рабочее пространство.

  4. Настройте клиент 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.

💻 Развитие

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

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

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

npm install

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

npm run dev

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

npm run build

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

{
  "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 в конфигурации.

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

🤝 Вклад

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

  1. Форк репозитория

  2. Создайте ветку функций ( git checkout -b feature/amazing-feature )

  3. Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )

  4. Отправить в ветку ( git push origin feature/amazing-feature )

  5. Открыть запрос на извлечение

Для запросов функций или отчетов об ошибках, пожалуйста, создайте проблему на 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"
  ]
}

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

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/awkoy/replicate-flux-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server