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ónCF_ACCOUNT_ID : ID de su cuenta de CloudflareCF_API_TOKEN : Su token de API de Cloudflare con acceso a la IA de WorkersFLUX_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:
- Construir el proyecto:
🛠 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 FluxFLUX_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