ARCHIVED — This repository is no longer maintained. Issues and pull requests are closed.

fal.ai Image MCP Server

Generate images from text prompts using fal.ai and the Model Context Protocol (MCP). Integrates with AI IDEs like Cursor and Windsurf.

Features

• Supports any valid fal.ai model and all major image parameters (size, inference steps, guidance scale, safety checker, batch of up to 5).

• Saves images locally with accessible file paths.

• Simple configuration and robust error handling.

Related MCP server: GIMP MCP

Quick Start

1. Requirements: Node.js 18+, fal.ai API key

2. Configure MCP:

   {
     "mcpServers": {
       "fal-ai-image": {
         "command": "npx",
         "args": ["-y", "mcp-fal-ai-image"],
         "env": { "FAL_KEY": "YOUR-FAL-AI-API-KEY" }
       }
     }
   }

3. Run: Use the generate-image tool from your IDE.

Example Prompts

• generate an image of a red apple

• generate an image of a red apple using model fal-ai/kolors

• generate 3 images of a glowing red apple in a futuristic city using model fal-ai/recraft-v3, square_hd, 40 inference steps, guidance scale 4.0, safety checker on

Supported parameters: prompt, model ID (any fal.ai model), number of images, image size, inference steps, guidance scale, safety checker.

Images are saved locally; file paths are shown in the response. For model IDs, see fal.ai/models.

Image Output

Generated images are saved to ~/Downloads/fal_ai by default (XDG-aware on Linux). Set FAL_IMAGES_OUTPUT_DIR to use a custom folder — images are saved to <your-folder>/fal_ai. The full file path for each image is included in the tool's response.

Troubleshooting

• FAL_KEY is not set: Set your fal.ai API key as shown above.

• Model errors: Double-check the model ID at fal.ai/models, or refer to the fal.ai API docs.

• npx not found: Install Node.js 18+ and npm.

• Other errors: Consult your MCP client logs.

Security

• Your API key is used only locally to authenticate with fal.ai.

• No user data is stored or transmitted except as required by the fal.ai API.

Links

• NPM

• GitHub

• fal.ai

License

MIT License © 2025 Madhusudan Kulkarni