README.md
Integrates fal.ai's image generation and editing capabilities into MCP
fal-mcp
An MCP server that wraps the fal.ai image generation API, giving Claude (or any MCP client) the ability to generate and edit images.
Tools
| Tool | Description |
|---|---|
generate_image |
Text-to-image generation with configurable model, size, steps, and guidance |
generate_with_reference |
Image generation guided by a style/content reference image |
generate_with_lora |
Image generation with a LoRA model applied |
edit_image |
Edit an existing image using natural language instructions (FLUX Kontext) |
raw_generate |
Submit arbitrary requests for advanced configurations (ControlNet, IP-Adapter, multi-LoRA) |
list_outputs |
List all saved images in the output directory |
Supported models
fal-ai/flux/dev— high quality (default)fal-ai/flux/schnell— fast, 1-4 stepsfal-ai/flux-pro/v1.1— professional, up to 2K resolutionfal-ai/flux-general— supports LoRA, ControlNet, IP-Adapterfal-ai/recraft/v3/text-to-image— illustration stylefal-ai/flux-pro/kontext— image editing
Setup
- Get an API key from fal.ai
- Set the
FAL_KEYenvironment variable (or add it to a.env.localfile in the parent directory)
Usage with Claude Code
Add this to your .mcp.json:
{
"mcpServers": {
"fal": {
"command": "uv",
"args": ["run", "--directory", "/path/to/fal-mcp", "python", "server.py"]
}
}
}
Dependencies
- Python >= 3.11
- FastMCP v2
- httpx
- python-dotenv
Tools (6)
generate_imageText-to-image generation with configurable model, size, steps, and guidancegenerate_with_referenceImage generation guided by a style/content reference imagegenerate_with_loraImage generation with a LoRA model appliededit_imageEdit an existing image using natural language instructionsraw_generateSubmit arbitrary requests for advanced configurationslist_outputsList all saved images in the output directoryEnvironment Variables
FAL_KEYrequiredAPI key from fal.aiConfiguration
claude_desktop_config.json
{"mcpServers": {"fal": {"command": "uv", "args": ["run", "--directory", "/path/to/fal-mcp", "python", "server.py"]}}}Try it
→Generate a high-quality image of a futuristic city using the flux dev model.
→Edit the image I just generated to change the sky color to sunset orange.
→Create an image of a cat in a cyberpunk style using the LoRA model.
→List all the images I have generated so far.