remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Integrates with Windsurf/Codeium Cascade (Wave 3+), allowing users to access image generation tools through Cascade's MCP toolbar and AI capabilities
Integrates with Flux's image generation API, allowing for text-to-image generation, image-to-image transformation, inpainting, and advanced image controls like edge-based, depth-aware, and pose-guided generation

Estudio MCP Flux

Un potente servidor de Protocolo de Contexto de Modelo (MCP) que integra las avanzadas capacidades de generación de imágenes de Flux con sus asistentes de programación de IA. Este servidor permite la integración directa de las funciones de generación, manipulación y control de imágenes de Flux en los IDE de Cursor y Windsurf (Codeium).

Descripción general

MCP Flux Studio cierra la brecha entre los asistentes de codificación de IA y la potente API de generación de imágenes de Flux, lo que permite una integración perfecta de las capacidades de generación de imágenes directamente en su flujo de trabajo de desarrollo.

Características

Generación de imágenes
- Generación de texto a imagen con control preciso
- Compatibilidad con múltiples modelos (flux.1.1-pro, flux.1-pro, flux.1-dev, flux.1.1-ultra)
- Relaciones de aspecto y dimensiones personalizables
Manipulación de imágenes
- Transformación de imagen a imagen
- Repintado con máscaras personalizables
- Aumento y mejora de la resolución
Controles avanzados
- Generación basada en bordes (canny)
- Generación consciente de la profundidad
- Generación guiada por poses
Integración IDE
- Soporte completo para Cursor (v0.45.7+)
- Compatible con Windsurf/Codeium Cascade (Wave 3+)
- Invocación fluida de herramientas a través de asistentes de IA

Inicio rápido

Prerrequisitos
- Node.js 18+
- Python 3.12+
- Clave API de Flux
- IDE compatible (Cursor o Windsurf)
Instalación

Instalación mediante herrería

Para instalar Flux Studio para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @jmanhype/mcp-flux-studio --client claude

Instalación manual

git clone https://github.com/jmanhype/mcp-flux-studio.git
cd mcp-flux-studio
npm install
npm run build

Configuración básica
BFL_API_KEY=your_flux_api_key FLUX_PATH=/path/to/flux/installation

Para obtener instrucciones de instalación detalladas, incluida la configuración y solución de problemas específicos de IDE, consulte nuestra Guía de instalación .

Documentación

Guía de instalación : instrucciones de configuración completas
Documentación de la API : documentación detallada de la herramienta
Ejemplo de uso : ejemplos de uso en el mundo real
Pautas para contribuir : Cómo contribuir

Integración IDE

Cursor (v0.45.7+)

MCP Flux Studio se integra perfectamente con el asistente de inteligencia artificial de Cursor:

Configuración
- Configurar a través de Configuración > Características > MCP
- Admite conexiones stdio y SSE
- Las variables de entorno se pueden configurar mediante scripts envolventes
Uso
- Herramientas disponibles automáticamente para el asistente de IA de Cursor
- Las invocaciones de herramientas requieren la aprobación del usuario
- Retroalimentación en tiempo real sobre el progreso de la generación

Windsurf/Codeium (Ola 3+)

Integración con Cascade AI de Windsurf:

Configuración
- Editar ~/.codeium/windsurf/mcp_config.json
- Admite la ejecución de herramientas basadas en procesos
- Variables de entorno configuradas en JSON
Uso
- Acceda a las herramientas a través de la barra de herramientas MCP de Cascade
- Descubrimiento y carga automática de herramientas
- Integrado con las capacidades de inteligencia artificial de Cascade

Para obtener instrucciones de configuración detalladas específicas de IDE, consulte la Guía de instalación .

Uso

El servidor proporciona las siguientes herramientas:

generar

Generar una imagen a partir de una solicitud de texto.

{
  "prompt": "A photorealistic cat",
  "model": "flux.1.1-pro",
  "aspect_ratio": "1:1",
  "output": "generated.jpg"
}

img2img

Generar una imagen utilizando otra imagen como referencia.

{
  "image": "input.jpg",
  "prompt": "Convert to oil painting",
  "model": "flux.1.1-pro",
  "strength": 0.85,
  "output": "output.jpg",
  "name": "oil_painting"
}

retocar

Repintar una imagen usando una máscara.

{
  "image": "input.jpg",
  "prompt": "Add flowers",
  "mask_shape": "circle",
  "position": "center",
  "output": "inpainted.jpg"
}

control

Generar una imagen utilizando control estructural.

{
  "type": "canny",
  "image": "control.jpg",
  "prompt": "A realistic photo",
  "output": "controlled.jpg"
}

Desarrollo

Estructura del proyecto

flux-mcp-server/
├── src/
│   ├── index.ts          # Main server implementation
│   └── types.ts          # TypeScript type definitions
├── tests/
│   └── server.test.ts    # Server tests
├── docs/
│   ├── API.md           # API documentation
│   └── CONTRIBUTING.md  # Contribution guidelines
├── examples/
│   ├── generate.json    # Example tool usage
│   └── config.json      # Example configuration
├── package.json
├── tsconfig.json
└── README.md

Ejecución de pruebas

npm test

Edificio

npm run build

Contribuyendo

Lea CONTRIBUTING.md para obtener detalles sobre nuestro código de conducta y el proceso para enviar solicitudes de extracción.

Licencia

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

Expresiones de gratitud

Protocolo de contexto del modelo : la especificación del protocolo
API de Flux : la API de generación de imágenes subyacente

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Tools

Un servidor que integra las funciones avanzadas de generación y manipulación de imágenes de Flux en asistentes de codificación de IA, lo que permite flujos de trabajo de control de imágenes y texto a imagen sin inconvenientes en IDE como Cursor y Windsurf.

Related Resources

Reddit Discussion about this server