Black Forest Labs

Provides AI assistants with image generation via FLUX models using the Black Forest Labs API, plus status checks and image downloads.

javascript

1

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "fernforestgames-mcp-server-bfl": {
      "command": "npx",
      "args": [
        "@fernforestgames/mcp-server-bfl"
      ],
      "env": {
        "BFL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can enable AI assistants to generate images using the Black Forest Labs API through a dedicated MCP server. This setup lets you request text-to-image generation with FLUX models, poll for progress, and retrieve image URLs for quick access and download.

How to use

After you configure the MCP server, your AI assistant can generate images by providing natural language prompts. For example, you can say “Generate an image of a sunset over mountains” or “Create a high-resolution photo of a cat using FLUX Pro Ultra.” The server automatically polls the Black Forest Labs API until generation finishes and returns a temporary image URL that you can share or download (valid for 10 minutes). You can also direct your assistant to download the final image directly.

How to install

Prerequisites you must have before installation are already installed on your system.

Install Node.js (version 22 or newer) on your machine.
Obtain your Black Forest Labs API key and keep it ready.
Create or edit your MCP configuration file named ".mcp.json" in your project root and add the server configuration snippet shown below.

{
  "mcpServers": {
    "bfl": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@fernforestgames/mcp-server-bfl"
      ],
      "env": {
        "BFL_API_KEY": "your-api-key-here"
      }
    }
  }
}

Additional steps to run

With the configuration in place, start your MCP-enabled workflow in your environment or platform that supports MCP servers. Use the named server (bfl) through your MCP client to send image generation requests and manage results.

Configuration notes

- The server is run locally via a stdio bridge using npx and the package that exposes the MCP server functionality.
- You must provide your API key via the BFL_API_KEY environment variable. Treat this key as sensitive and do not commit it in public repositories.

Security and licensing

Keep your API key secure and rotate it if you suspect exposure. The server operates under the MIT License.

Available tools

generate_image

Requests image generation from the FLUX model using a given prompt and model settings; returns an image URL and progress status.

check_status

Polls or queries the API for the current status of an ongoing image generation task.

download_image

Downloads the final generated image using the provided URL or downloads it directly when requested.