Fal Reve

Provides access to Reve via MCP, generating high-quality images with automatic local downloads and flexible output options.

typescript

1

GitHub Stars

typescript

Language

5 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": {
    "pierrunoyt-fal-reve-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/PierrunoYT/fal-reve-mcp-server.git"
      ],
      "env": {
        "FAL_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can run a dedicated MCP server that uses the Reve text-to-image model through FAL AI. It handles prompts, multiple image outputs, and automatic local downloads, making it easy to generate and manage visual content from your MCP clients with reliable error handling and flexible output formats.

How to use

Connect your MCP client to the fal-reve MCP server to create images from text prompts. You can generate a single image or a batch of up to four images, choose an aspect ratio from several presets, and select the output format (png, jpeg, or webp). The server returns both local file paths and original image URLs, so you can display results and reference remote sources.

How to install

# Prerequisites
- Node.js 18 or higher
- FAL AI API key

# Step 1: Get your FAL AI API Key
#  - Visit FAL AI and sign up
#  - Generate an API key on your dashboard

# Step 2: Start a universal npx configuration (no local install required)
# This runs the MCP server directly from the repository

{ "mcpServers": { "fal-reve": { "command": "npx", "args": [ "-y", "https://github.com/PierrunoYT/fal-reve-mcp-server.git" ], "env": { "FAL_KEY": "your-fal-api-key-here" } } } }

## Configuration and usage notes

The server supports one key environment variable: FAL\_KEY. It is optional to run the server, but you must provide a valid key to access the Reve API with full features. If the key is missing, the server continues to run and responds with informative errors for API-key related issues.

Two common setup paths exist: (1) universal npx configuration for portability and (2) local installation for in-depth control. The universal path downloads and runs the server on demand without local installation, while the local path compiles TypeScript to JavaScript and runs the built index file.

## Troubleshooting and tips

If the MCP server does not appear in your client, try the universal npx configuration first for maximum compatibility. If you use a local installation, verify the path to the built runtime and ensure Node.js 18+ is installed. Restart your MCP client after making changes.

Ensure the Reve model is available in your region and that your API key has sufficient credits. For long or complex prompts, consider using the async queue tool to prevent timeouts and to receive progress updates.

## Examples and available outputs

Basic generation: provide a descriptive prompt and choose an aspect ratio and output format. The server downloads generated images automatically to a local images directory and returns both local paths and remote URLs.

Output formats supported: PNG, JPEG, and WebP. Multiple aspect ratios are available: 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, and 1:1.

## Available tools

### reve\_generate

Generates images using Reve in real-time with options for prompt, number of images, aspect ratio, and output format. Returns image URLs, metadata, and local download paths.

### reve\_generate\_async

Queues image requests for asynchronous processing, suitable for multiple images or longer prompts, with progress updates and detailed logging.