Flux Cloudflare MCP

Un potente servidor de Protocolo de Contexto de Modelo (MCP) que proporciona a los asistentes de IA la capacidad de generar imágenes utilizando el modelo Flux de Black Forest Labs a través de una API de Cloudflare Worker.

Instalación • Características • Uso • Documentación • Contribución

🌟 Características

• 🖼️ Generación de imágenes de alta calidad : acceso a Flux, un modelo de generación de imágenes de última generación

• 🤖 Integración perfecta con IA : permite que los asistentes de IA como Claude generen imágenes directamente

• 🎛️ Parámetros personalizables : controle la relación de aspecto, los pasos de inferencia y más

• 🔌 Compatible con MCP : funciona con cualquier cliente MCP (Cursor, Claude Desktop, Cline, Zed, etc.)

• 🔒 Procesamiento local : todas las solicitudes se procesan de forma segura a través de Cloudflare Worker

• 💬 Finalizaciones de chat : obtén finalizaciones de texto usando la misma API

Related MCP server: FLUX Image Generator MCP Server

📦 Instalación

Uso directo con NPX

FLUX_API_TOKEN=your_token FLUX_API_URL=your_api_url npx -y flux-cloudflare-mcp

De la fuente

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

# Install dependencies
npm install

# Build the project
npm run build

🚀 Configuración de su API de Flux

Este servidor MCP requiere un punto final de la API de Flux para funcionar. Tiene dos opciones para configurar la API:

Opción 1: Implementar usando snakeying/flux-api-worker (recomendado)

snakeying/flux-api-worker proporciona un Cloudflare Worker simple y eficiente para acceder al modelo Flux:

1. Bifurcar el repositorio flux-api-worker

2. Implementarlo en Cloudflare Workers:

   • Crea un nuevo trabajador en tu panel de Cloudflare

   • Conéctalo a tu repositorio bifurcado

   • Configure las variables de entorno requeridas:

     • API_KEY : Su clave API elegida para la autenticación

     • CF_ACCOUNT_ID : ID de su cuenta de Cloudflare

     • CF_API_TOKEN : Su token de API de Cloudflare con acceso a la IA de Workers

     • FLUX_MODEL : El modelo Flux a utilizar (predeterminado: "@cf/black-forest-labs/flux-1-schnell")

3. Una vez implementada, su API estará disponible en https://your-worker-name.your-subdomain.workers.dev

4. Utilice esta URL como su FLUX_API_URL y su clave API elegida como FLUX_API_TOKEN

Opción 2: Implementar usando aigem/cf-flux-remix

Para una implementación con más funciones y una interfaz de usuario web, puede utilizar aigem/cf-flux-remix :

1. Siga las instrucciones de instalación en el repositorio cf-flux-remix

2. Una vez implementada, su API estará disponible en su URL implementada

3. Utilice esta URL como su FLUX_API_URL y su clave API configurada como FLUX_API_TOKEN

📚 Documentación

Herramientas disponibles

generate_image

Genera una imagen basada en una solicitud de texto utilizando el modelo Flux.

{
  prompt: string;                // Required: Text description of the image to generate
  num_inference_steps?: number;  // Optional: Number of denoising steps (1-4) (default: 4)
  aspect_ratio?: string;         // Optional: Aspect ratio (e.g., "16:9", "4:3") (default: "1:1")
}

🔧 Uso

Integración del cursor

Método 1: Usar mcp.json

1. Cree o edite el archivo .cursor/mcp.json en el directorio de su proyecto:

{
  "mcpServers": {
    "flux-cloudflare-mcp": {
      "command": "env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx",
      "args": ["-y", "flux-cloudflare-mcp"]
    }
  }
}

2. Reemplace YOUR_TOKEN con su token de API de Flux real y YOUR_API_URL con la URL de su API

3. Reinicie el cursor para aplicar los cambios

Método 2: Uso de la configuración del cursor MCP

1. Abra Cursor y vaya a Configuración

2. Vaya a la sección "MCP" o "Protocolo de contexto de modelo"

3. Haga clic en "Agregar servidor" o equivalente

4. Introduzca el siguiente comando en el campo correspondiente:

env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx -y flux-cloudflare-mcp

5. Reemplace YOUR_TOKEN con su token de API de Flux real y YOUR_API_URL con la URL de su API

6. Guarde la configuración y reinicie Cursor si es necesario

Integración de escritorio de Claude

env FLUX_API_TOKEN=SU_TOKEN FLUX_API_URL=SU_API_URL npx -y flux-cloudflare-mcp

{
  "mcpServers": {
    "flux-cloudflare-mcp": {
      "command": "npx",
      "args": ["-y", "flux-cloudflare-mcp"],
      "env": {
        "FLUX_API_TOKEN": "YOUR_TOKEN",
        "FLUX_API_URL": "YOUR_API_URL"
      }
    }
  }
}

💻 Desarrollo local

1. Clonar el repositorio:

git clone https://github.com/Hzzy2O/flux-cloudflare-mcp.git
cd flux-cloudflare-mcp

2. Instalar dependencias:

npm install

3. Construir el proyecto:

npm run build

🛠 Pila técnica

• SDK del Protocolo de Contexto de Modelo: funcionalidad principal de MCP

• Cloudflare Workers: API sin servidor para la generación de imágenes

• TypeScript: seguridad de tipos y funciones modernas de JavaScript

• Zod - Validación de tipos en tiempo de ejecución

⚙️ Configuración

El servidor requiere las siguientes variables de entorno:

• FLUX_API_TOKEN : Su token de API para la autenticación con la API de Flux

• FLUX_API_URL : La URL de su API Flux implementada (desde snakeying/flux-api-worker o aigem/cf-flux-remix)

🔍 Solución de problemas

Problemas comunes

Error de autenticación

• Asegúrese de que su FLUX_API_TOKEN esté configurado correctamente en el entorno

• Verifique que su token sea válido probándolo directamente con la API de Flux

Problemas de conexión de la API

• Comprueba que tu API Flux (Cloudflare Worker) esté en ejecución y sea accesible

• Asegúrese de que su red permita conexiones a Cloudflare Workers

Filtro de seguridad activado

• El modelo tiene un filtro de seguridad incorporado que puede bloquear ciertas indicaciones.

• Intente modificar su mensaje para evitar contenido potencialmente problemático

🤝 Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

🔗 Recursos

• Documentación del protocolo de contexto del modelo

• Documentación de Cloudflare Workers

• Documentación del modelo de flujo

• SDK de TypeScript para MCP

• snakeying/flux-api-worker - Implementación simple de la API de Flux

• aigem/cf-flux-remix : API Flux con numerosas funciones e interfaz web