MCP Replicate FLUX

Genera imágenes usando el modelo FLUX de Replicate y las almacena en Cloudflare R2.

GitHub
11
Prueba este MCPPatrocinado

Documentación

MCP Replicate FLUX

smithery badge

Un servidor de Protocolo de Contexto de Modelo (MCP) que genera imágenes utilizando el modelo FLUX de Replicate y las almacena en Cloudflare R2.

使用 Replicate 的 FLUX 模型生成图片并存储到 Cloudflare R2 的模型上下文协议（MCP）服务器。

Características 功能特点

  • Genera imágenes utilizando el modelo black-forest-labs/flux-schnell de Replicate
  • Almacena las imágenes generadas en Cloudflare R2
  • Devuelve URLs de imágenes accesibles
  • Soporte para prompts personalizados y nombres de archivo
  • 使用 Replicate 的 black-forest-labs/flux-schnell 模型生成图片
  • 将生成的图片存储到 Cloudflare R2
  • 返回可访问的图片链接
  • 支持自定义提示词和文件名

Requisitos previos 前置要求

  • Node.js (v16 o superior)
  • Token de API de Replicate
  • Bucket de Cloudflare R2 y credenciales
  • npm o yarn
  • Node.js（v16 或更高版本）
  • Replicate API 令牌
  • Cloudflare R2 存储桶和凭证
  • npm 或 yarn

Variables de entorno 环境变量

Variables de entorno requeridas en el archivo .env:

.env 文件中需要的环境变量：

REPLICATE_API_TOKEN=your_replicate_token
STORAGE_ENDPOINT=your_r2_endpoint
STORAGE_ACCESS_KEY=your_r2_access_key
STORAGE_SECRET_KEY=your_r2_secret_key
STORAGE_BUCKET=your_bucket_name
STORAGE_DOMAIN=your_domain

Instalación local 本地安装

Instalación mediante Smithery

Para instalar MCP Replicate FLUX para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @andylee20014/mcp-replicate-flux --client claude

Instalación manual

Siga estos pasos para configurar el proyecto localmente:

按照以下步骤在本地设置项目：

# Clone the repository
git clone https://github.com/andylee20014/mcp-replicate-flux.git
cd mcp-replicate-flux

# Install dependencies
npm install

# Create .env file and add your credentials
cp .env.example .env
# Edit .env with your actual credentials

Asegúrese de que su bucket de Cloudflare R2 tenga la configuración CORS adecuada para el acceso público a las imágenes subidas.

确保您的 Cloudflare R2 存储桶具有适当的 CORS 设置，以允许公共访问上传的图片。

Ejecución local 本地运行

Para iniciar el servidor MCP localmente:

在本地启动 MCP 服务器：

node index.js

El servidor se iniciará y escuchará mensajes del protocolo MCP en la entrada/salida estándar.

服务器将启动并通过标准输入/输出监听 MCP 协议消息。

Uso 使用方法

El servidor proporciona una herramienta generate-image que acepta dos parámetros:

  • prompt: El prompt de texto para la generación de imágenes
  • filename: El nombre de archivo deseado para la imagen generada

服务器提供了一个 generate-image 工具，接受两个参数：

  • prompt ：用于生成图片的文本提示词
  • filename ：生成的图片所需的文件名

Ejemplo de integración 集成示例

Aquí hay un ejemplo de cómo integrarse con este servidor MCP usando la biblioteca cliente MCP:

以下是使用 MCP 客户端库与此 MCP 服务器集成的示例：

const { McpClient } = require('@modelcontextprotocol/sdk/client/mcp.js')

async function generateImage(prompt, filename) {
  const client = new McpClient()
  // Connect to your running MCP server
  await client.connect(yourTransport)
  
  const result = await client.tools.call('generate-image', {
    prompt,
    filename
  })
  
  return result
}

Respuesta de ejemplo 示例响应：

{
  "content": [
    { "type": "text", "text": "Image successfully generated and uploaded to Cloudflare R2" },
    { "type": "image", "url": "https://your-domain.com/filename.jpg" }
  ]
}

Pruebas 测试

Se proporciona un script de prueba para verificar la funcionalidad de generación y carga de imágenes.

提供了一个测试脚本，用于验证图片生成和上传功能。

Ejecutar la prueba 运行测试

node test.js

El script de prueba:

  1. Generará una imagen con un prompt de muestra
  2. Subirá la imagen a Cloudflare R2
  3. Devolverá la URL accesible

测试脚本将：

  1. 使用示例提示词生成图片
  2. 将图片上传到 Cloudflare R2
  3. 返回可访问的 URL

Salida de prueba de ejemplo 测试输出示例：

Generating image with prompt: "a beautiful girl"
Filename: test-1234567890.jpg
Image generated and uploaded successfully!
Image URL: https://your-domain.com/test-1234567890.jpg

Puede modificar el prompt en test.js para probar diferentes escenarios de generación de imágenes.

您可以在 test.js 中修改提示词来测试不同的图片生成场景。

Configuración de MCP en Cursor Cursor MCP配置

Hay dos formas de configurar el servidor MCP en Cursor:

在Cursor中配置MCP服务器有两种方式：

Método 1: Configuración completa 完整配置方式

Cree un archivo en ~/.cursor/mcp.json con todas las variables de entorno:

在 ~/.cursor/mcp.json 创建完整配置文件，包含所有环境变量：

{
  "mcpServers": {
    "replicate-flux": {
      "command": "node",
      "args": ["C:\\Users\\YourUsername\\path\\to\\mcp-replicate-flux\\index.js"],
      "description": "使用Replicate的FLUX模型生成图片并存储到Cloudflare R2的MCP服务器",
      "env": {
        "REPLICATE_API_TOKEN": "your_replicate_token",
        "STORAGE_ENDPOINT": "your_r2_endpoint",
        "STORAGE_ACCESS_KEY": "your_r2_access_key",
        "STORAGE_SECRET_KEY": "your_r2_secret_key",
        "STORAGE_BUCKET": "your_bucket_name",
        "STORAGE_DOMAIN": "your_domain"
      }
    }
  }
}

Método 2: Configuración mínima 最小配置方式

Si prefiere gestionar las variables de entorno por separado (usando variables de entorno del sistema o un archivo .env), puede usar una configuración mínima:

如果你想单独管理环境变量（使用系统环境变量或.env文件），可以使用最小配置：

{
  "mcpServers": {
    "replicate-flux": {
      "command": "node",
      "args": ["C:\\Users\\YourUsername\\path\\to\\mcp-replicate-flux\\index.js"]
    }
  }
}

Al usar la configuración mínima, asegúrese de que sus variables de entorno estén configuradas correctamente en:

  • Variables de entorno del sistema
  • Archivo .env en el directorio del proyecto
  • Variables de entorno de la plataforma en la nube (para servidores desplegados)

使用最小配置时，请确保你的环境变量正确设置在以下位置之一：

  • 系统环境变量
  • 项目目录中的 .env 文件
  • 云平台的环境变量（对于已部署的服务器）

Notas 注意事项

  • El campo description es opcional en ambos métodos
  • Las variables de entorno en el archivo de configuración tienen prioridad sobre las variables de entorno del sistema
  • Después de cambiar la configuración, reinicie Cursor para aplicar los cambios
  • description 描述字段在两种方式中都是可选的
  • 配置文件中的环境变量优先级高于系统环境变量
  • 更改配置后，需要重启Cursor以应用更改

Estructura del proyecto 项目结构

mcp-replicate-flux/
├── .env                  # Environment variables
├── index.js             # MCP server entry point
├── generateImage.js      # Image generation and R2 upload logic
├── test.js              # Test script
└── README.md            # Project documentation

Solución de problemas 故障排除

Problemas comunes 常见问题

  1. La generación de imágenes falla: Verifique su token de API de Replicate y su cuota
  2. La carga a R2 falla: Verifique sus credenciales de R2 y los permisos del bucket
  3. No se pueden acceder a las imágenes generadas: Asegúrese de que su bucket de R2 tenga la configuración CORS adecuada
  4. 图片生成失败 ：检查您的 Replicate API 令牌和配额
  5. R2 上传失败 ：验证您的 R2 凭证和存储桶权限
  6. 无法访问生成的图片 ：确保您的 R2 存储桶具有正确的 CORS 配置

Protocolo MCP 协议说明

El Protocolo de Contexto de Modelo (MCP) es un estándar para la interacción con modelos de IA que permite la interoperabilidad entre diferentes sistemas de IA. Este servidor implementa una herramienta MCP que puede usarse con cualquier cliente compatible con MCP.

模型上下文协议（MCP）是一种 AI 模型交互标准，可实现不同 AI 系统之间的互操作性。此服务器实现了一个 MCP 工具，可与任何兼容 MCP 的客户端一起使用。