npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@mseep/flux-cloudflare-mcp

v0.0.1

Published

MCP for Flux Image Generation with Cloudflare Worker

Readme

Flux Cloudflare MCP

MCP Compatible License TypeScript Model Context Protocol

A powerful Model Context Protocol (MCP) server that provides AI assistants with the ability to generate images using Black Forest Labs' Flux model via a Cloudflare Worker API.

Installation • Features • Usage • Documentation • Contributing


🌟 Features

  • 🖼️ High-Quality Image Generation: Access to Flux, a state-of-the-art image generation model
  • 🤖 Seamless AI Integration: Enable AI assistants like Claude to generate images directly
  • 🎛️ Customizable Parameters: Control aspect ratio, inference steps, and more
  • 🔌 MCP Compatible: Works with any MCP client (Cursor, Claude Desktop, Cline, Zed, etc.)
  • 🔒 Local Processing: All requests are processed securely through the Cloudflare Worker
  • 💬 Chat Completions: Get text completions using the same API

📦 Installation

Direct Usage with NPX

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

From Source

# 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

🚀 Setting Up Your Flux API

This MCP server requires a Flux API endpoint to function. You have two options for setting up the API:

Option 1: Deploy using snakeying/flux-api-worker (Recommended)

snakeying/flux-api-worker provides a simple and efficient Cloudflare Worker for accessing the Flux model:

  1. Fork the flux-api-worker repository
  2. Deploy it to Cloudflare Workers:
    • Create a new Worker in your Cloudflare dashboard
    • Connect it to your forked repository
    • Set up the required environment variables:
      • API_KEY: Your chosen API key for authentication
      • CF_ACCOUNT_ID: Your Cloudflare account ID
      • CF_API_TOKEN: Your Cloudflare API token with Workers AI access
      • FLUX_MODEL: The Flux model to use (default: "@cf/black-forest-labs/flux-1-schnell")
  3. Once deployed, your API will be available at https://your-worker-name.your-subdomain.workers.dev
  4. Use this URL as your FLUX_API_URL and your chosen API key as FLUX_API_TOKEN

Option 2: Deploy using aigem/cf-flux-remix

For a more feature-rich implementation with a web UI, you can use aigem/cf-flux-remix:

  1. Follow the installation instructions in the cf-flux-remix repository
  2. Once deployed, your API will be available at your deployed URL
  3. Use this URL as your FLUX_API_URL and your configured API key as FLUX_API_TOKEN

📚 Documentation

Available Tools

generate_image

Generates an image based on a text prompt using the Flux model.

{
  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")
}

🔧 Usage

Cursor Integration

Method 1: Using mcp.json

  1. Create or edit the .cursor/mcp.json file in your project directory:
{
  "mcpServers": {
    "flux-cloudflare-mcp": {
      "command": "env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx",
      "args": ["-y", "flux-cloudflare-mcp"]
    }
  }
}
  1. Replace YOUR_TOKEN with your actual Flux API token and YOUR_API_URL with your API URL
  2. Restart Cursor to apply the changes

Method 2: Using Cursor MCP Settings

  1. Open Cursor and go to Settings
  2. Navigate to the "MCP" or "Model Context Protocol" section
  3. Click "Add Server" or equivalent
  4. Enter the following command in the appropriate field:
env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx -y flux-cloudflare-mcp
  1. Replace YOUR_TOKEN with your actual Flux API token and YOUR_API_URL with your API URL
  2. Save the settings and restart Cursor if necessary

Claude Desktop Integration

env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_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"
      }
    }
  }
}

💻 Local Development

  1. Clone the repository:
git clone https://github.com/Hzzy2O/flux-cloudflare-mcp.git
cd flux-cloudflare-mcp
  1. Install dependencies:
npm install
  1. Build the project:
npm run build

🛠 Technical Stack

  • Model Context Protocol SDK - Core MCP functionality
  • Cloudflare Workers - Serverless API for image generation
  • TypeScript - Type safety and modern JavaScript features
  • Zod - Runtime type validation

⚙️ Configuration

The server requires the following environment variables:

  • FLUX_API_TOKEN: Your API token for authentication with the Flux API
  • FLUX_API_URL: The URL of your deployed Flux API (from snakeying/flux-api-worker or aigem/cf-flux-remix)

🔍 Troubleshooting

Common Issues

Authentication Error

  • Ensure your FLUX_API_TOKEN is correctly set in the environment
  • Verify your token is valid by testing it with the Flux API directly

API Connection Issues

  • Check that your Flux API (Cloudflare Worker) is running and accessible
  • Ensure your network allows connections to Cloudflare Workers

Safety Filter Triggered

  • The model has a built-in safety filter that may block certain prompts
  • Try modifying your prompt to avoid potentially problematic content

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

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

🔗 Resources

smithery badge