Skip to main content
Glama
enesjakozh

MCP Flux Studio

by jmanhype
GitHub
Python
MIT License
20
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP Flux Studio

smithery badge

A powerful Model Context Protocol (MCP) server that brings Flux's advanced image generation capabilities to your AI coding assistants. This server enables direct integration of Flux's image generation, manipulation, and control features into Cursor and Windsurf (Codeium) IDEs.

Overview

MCP Flux Studio bridges the gap between AI coding assistants and Flux's powerful image generation API, allowing seamless integration of image generation capabilities directly into your development workflow.

Features

  • Image Generation

    • Text-to-image generation with precise control

    • Multiple model support (flux.1.1-pro, flux.1-pro, flux.1-dev, flux.1.1-ultra)

    • Customizable aspect ratios and dimensions

  • Image Manipulation

    • Image-to-image transformation

    • Inpainting with customizable masks

    • Resolution upscaling and enhancement

  • Advanced Controls

    • Edge-based generation (canny)

    • Depth-aware generation

    • Pose-guided generation

  • IDE Integration

    • Full support for Cursor (v0.45.7+)

    • Compatible with Windsurf/Codeium Cascade (Wave 3+)

    • Seamless tool invocation through AI assistants

Quick Start

  1. Prerequisites

    • Node.js 18+

    • Python 3.12+

    • Flux API key

    • Compatible IDE (Cursor or Windsurf)

  2. Installation

Installing via Smithery

To install Flux Studio for Claude Desktop automatically via Smithery:

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

Manual Installation

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

  1. Basic Configuration

    BFL_API_KEY=your_flux_api_key FLUX_PATH=/path/to/flux/installation

For detailed setup instructions, including IDE-specific configuration and troubleshooting, see our Installation Guide.

Documentation

IDE Integration

Cursor (v0.45.7+)

MCP Flux Studio integrates seamlessly with Cursor's AI assistant:

  1. Configuration

    • Configure via Settings > Features > MCP

    • Supports both stdio and SSE connections

    • Environment variables can be set via wrapper scripts

  2. Usage

    • Tools automatically available to Cursor's AI assistant

    • Tool invocations require user approval

    • Real-time feedback on generation progress

Windsurf/Codeium (Wave 3+)

Integration with Windsurf's Cascade AI:

  1. Configuration

    • Edit ~/.codeium/windsurf/mcp_config.json

    • Supports process-based tool execution

    • Environment variables configured in JSON

  2. Usage

    • Access tools through Cascade's MCP toolbar

    • Automatic tool discovery and loading

    • Integrated with Cascade's AI capabilities

For detailed IDE-specific setup instructions, see the Installation Guide.

Usage

The server provides the following tools:

generate

Generate an image from a text prompt.

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

img2img

Generate an image using another image as reference.

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

inpaint

Inpaint an image using a mask.

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

control

Generate an image using structural control.

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

Development

Project Structure

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

Running Tests

npm test

Building

npm run build

Contributing

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

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.

Tools

A server that integrates Flux's advanced image generation and manipulation features into AI coding assistants, enabling seamless text-to-image and image control workflows in IDEs like Cursor and Windsurf.

  1. Overview
    1. Features
  2. Quick Start
    1. Installing via Smithery
    2. Manual Installation
  3. Documentation
    1. IDE Integration
      1. Cursor (v0.45.7+)
      2. Windsurf/Codeium (Wave 3+)
    2. Usage
      1. generate
      2. img2img
      3. inpaint
      4. control
    3. Development
      1. Project Structure
      2. Running Tests
      3. Building
    4. Contributing
      1. License
        1. Acknowledgments

          Related Resources

          Related MCP Servers

          • Apifox MCP Serverofficial

            apifox
            -
            security
            F
            license
            -
            quality
            A server that connects AI coding assistants like Cursor and Cline to Apifox API definitions, allowing developers to implement API interfaces through natural language commands.
            Last updated -
            412
            41
            • Apple
            • Linux

          • Minimax MCP Tools

            PsychArch
            A
            security
            A
            license
            A
            quality
            An MCP server implementation that integrates with Minimax API to provide AI-powered image generation and text-to-speech functionality in editors like Windsurf and Cursor.
            Last updated -
            2
            6
            51
            MIT License
            • Apple

          • Flux Cloudflare MCP

            Hzzy2O
            A
            security
            A
            license
            A
            quality
            An MCP server that enables AI assistants to generate images using Black Forest Labs' Flux model via Cloudflare Workers.
            Last updated -
            1
            MIT License

          • Figma MCP Server

            rlagudals95
            -
            security
            A
            license
            -
            quality
            Gives AI-powered coding tools like Cursor, Windsurf, and Cline access to Figma design files, enabling more accurate code generation directly from Figma designs.
            Last updated -
            106,929
            MIT License

          View all related MCP servers

          Appeared in Searches

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/jmanhype/mcp-flux-studio'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server