antigravity-v-flux-image-mcp

A Model Context Protocol (MCP) server that provides tools for image generation and editing using the FLUX.2 API by Black Forest Labs (BFL).

Features

• flux_generate_image: Generate high-fidelity images from text prompts.
• flux_edit_image: Edit existing images using instructions and multiple reference images.
• Support for FLUX.2 [pro] and [flex]: Choose between production speed and maximum quality.
• Local File Support: Automatically handles local file paths by converting them to base64 for the API.

Installation

Prerequisites

• Node.js (v18 or higher)
• A Black Forest Labs API Key

Global Installation

npm install -g antigravity-v-flux-image-mcp

Configuration

To use this with an MCP client (like Claude Desktop or Cursor), add the following to your configuration file:

Claude Desktop

%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "antigravity-v-flux-image-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "antigravity-v-flux-image-mcp"
      ],
      "env": {
        "BFL_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Tools

1. flux_generate_image

Generates an image from a prompt.

• api_key (Required): Your BFL API Key.
• prompt (Required): Text description of the image.
• negative_prompt (Optional): Things to exclude.
• width / height (Optional): Dimensions (default 1024x1024).
• mode (Optional): "pro" (default) or "flex".

2. flux_edit_image

Edits an existing image.

• api_key (Required): Your BFL API Key.
• prompt (Required): What you want to change.
• input_image (Required): URL or local file path of the base image.
• ref_images (Optional): List of additional reference images (paths or URLs).
• mode (Optional): "pro" (default) or "flex".

License

MIT