Mcp Server FalAI
About
A Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.
Details
- Author
- codecraftm
- Downloads
- 670
- Categories
- Other
Jump to
- Generate images from text prompts with multiple styles
- Supports 20+ anime and artistic styles (e.g., Ghibli, Pixar, Cyberpunk)
- Multiple image sizes: square, portrait, and landscape
- Generate up to 4 images in a single request
- Image upscaling with 4x resolution enhancement
- Image search and replace using a mask and prompt
- Built‑in NSFW content detection
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Mcp Server FalAICommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via npm install, set the FALAI_API_KEY environment variable, and add the server to your mcpServers configuration. Start the server in STDIO mode (default) or REST mode with optional --port and --endpoint flags.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp server falai": {
"falai": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"FALAI_API_KEY",
"chatmcp/falai"
],
"env": {
"FALAI_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}
}McpServers
{
"falai": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"FALAI_API_KEY",
"chatmcp/falai"
],
"env": {
"FALAI_API_KEY": "YOUR_API_KEY_HERE"
}
}
}MCP Image Generator
A Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.
Features
- Generate high-quality images from text prompts
- Support for multiple anime and artistic styles:
- Ghibli Style
- Pixar Style
- Pokemon Style
- Genshin Impact Style
- Cyberpunk Style
- One Piece Style
- Attack on Titan Style
- Shinkai Makoto Style
- Sailor Moon Style
- Evangelion Style
- Disney Princess Style
- Kyoto Animation Style
- Dreamworks Animation Style
- Marvel Studios Style
- DC Comics Style
- Kawaii Pastel Style
- Simpsons Style
- Dragon Ball Style
- Demon Slayer Style
- Warner Bros Animation Style
- Dark Fantasy Style
- And many more Japanese anime styles
- Multiple image size options:
- Square (512x512)
- Square HD (1024x1024)
- Portrait 4:3 (768x1024)
- Portrait 16:9 (576x1024)
- Landscape 4:3 (1024x768)
- Landscape 16:9 (1024x576)
- Generate multiple images in one request (up to 4)
- Image upscaling (4x resolution enhancement)
- Image search and replace functionality
- Built-in NSFW content detection
Installation
1. Clone the repository:
git clone [repository-url]
cd mcp-falai
2. Install dependencies:
npm install
3. Configure environment variables:
Create a .env file with the following content:
FALAI_API_KEY=your_fal_ai_key_here
Usage
MCP Server Configuration
To use the MCP Image Generator server, add it to your mcpServers configuration:
{
"mcpServers": {
"image-generator": {
"command": "npx",
"args": ["-y", "mcp-falai"]
}
}
}
You can also specify additional configuration options:
{
"mcpServers": {
"falai": {
"command": "npx",
"args": [
"-y",
"mcp-falai",
"--mode=rest",
"--port=9593",
"--endpoint=/rest"
],
"env": {
"FALAI_API_KEY": "your_fal_ai_key_here"
}
}
}
}
Starting the Server
The server can run in two modes:
1. STDIO mode (default):
npm start
2. REST mode:
npm start -- --mode=rest --port=9593 --endpoint=/rest
API Reference
Generate Image
Request Format:
{
"name": "generate_image",
"arguments": {
"prompt": "A beautiful sunset over mountains",
"style": "ghibli-style",
"num_images": 1,
"size": "square_hd"
}
}
Parameters:
- prompt (required): Text description of the image to generate
- style (optional): Image style (default: "ghibli-style")
- Available styles: See the Features section above for the complete list
- num_images (optional): Number of images to generate (1-4, default: 1)
- size (optional): Image size (default: "square_hd")
- Available sizes: "square", "square_hd", "portrait_4_3", "portrait_16_9", "landscape_4_3", "landscape_16_9"
Upscale Image
Request Format:
{
"name": "upscale_image",
"arguments": {
"image_url": "https://example.com/image.jpg"
}
}
Parameters:
- image_url (required): URL of the image to upscale
Search and Replace
Request Format:
{
"name": "search-and-replace",
"arguments": {
"image_url": "https://example.com/image.jpg",
"mask_url": "https://example.com/mask.jpg",
"prompt": "Description of the replacement"
}
}
Parameters:
- image_url (required): URL of the image to edit
- mask_url (required): URL of the mask image (black areas preserved, white areas inpainted)
- prompt (required): Description of the replacement content
Development
- npm run build: Build the project
- npm run watch: Watch mode for development
- npm run inspector: Run MCP inspector
Error Handling
The server provides detailed error messages for common issues:
- Missing API key
- Invalid prompt
- Invalid style or size parameters
- API request failures
- NSFW content detection
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
