Integrations

Leverages Cloudflare Workers to securely process image generation requests through Black Forest Labs' Flux model
Provides access to Black Forest Labs' Flux model for high-quality image generation based on text prompts
Utilizes TypeScript 4.9+ for type safety and modern JavaScript features in the MCP implementation

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

📦 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:

Bifurcar el repositorio flux-api-worker
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")
Una vez implementada, su API estará disponible en https://your-worker-name.your-subdomain.workers.dev
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 :

Siga las instrucciones de instalación en el repositorio cf-flux-remix
Una vez implementada, su API estará disponible en su URL implementada
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

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"]
    }
  }
}

Reemplace YOUR_TOKEN con su token de API de Flux real y YOUR_API_URL con la URL de su API
Reinicie el cursor para aplicar los cambios

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

Abra Cursor y vaya a Configuración
Vaya a la sección "MCP" o "Protocolo de contexto de modelo"
Haga clic en "Agregar servidor" o equivalente
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

Reemplace YOUR_TOKEN con su token de API de Flux real y YOUR_API_URL con la URL de su API
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

Clonar el repositorio:

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

Instalar dependencias:

npm install

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.

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servidor MCP que permite a los asistentes de IA generar imágenes utilizando el modelo Flux de Black Forest Labs a través de Cloudflare Workers.