Aiimagemultistyle

by codecraftm

Recommended
507 downloads
Not rated
GitHub

About

A Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

Details

Author
codecraftm
Downloads
507
Categories
Other

- Generate high-quality images from text prompts.
- Supports over 20 artistic styles including Ghibli, Pixar, and Cyberpunk.
- Multiple output sizes: square, portrait, and landscape ratios.
- Generate up to 4 images in a single request.
- Upscale images to 4x resolution enhancement.
- Search-and-replace editing 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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Aiimagemultistyle
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the package via npm install, set the FALAI_API_KEY environment variable, and add Aiimagemultistyle to your MCP client’s mcpServers configuration. The server can run in STDIO mode (default) or REST mode (with --mode=rest --port=9593 --endpoint=/rest). Invoke the generate_image, upscale_image, or search-and-replace tools through the MCP protocol.

generate_image

Generate images using fal.ai with various styles and options.

upscale_image

Enhance image resolution by 4x using fal.ai upscaling.

search-and-replace

Replace objects or elements in an image using text descriptions.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "aiimagemultistyle": {
            "image-generator": {
                "command": "npx",
                "args": [
                    "-y",
                    "aiimagemultistyle"
                ],
                "env": {
                    "FALAI_API_KEY": "your_fal_ai_key_here"
                }
            }
        }
    }
}

McpServers

{
    "image-generator": {
        "command": "npx",
        "args": [
            "-y",
            "aiimagemultistyle"
        ],
        "env": {
            "FALAI_API_KEY": "your_fal_ai_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: ``bash git clone [repository-url] cd aiimagemultistyle ` 2. Install dependencies: `bash 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: `json { "mcpServers": { "image-generator": { "command": "npx", "args": ["-y", "aiimagemultistyle"] } } } ` You can also specify additional configuration options: `json { "mcpServers": { "image-generator": { "command": "npx", "args": [ "-y", "aiimagemultistyle", "--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):
`bash npm start ` 2. REST mode: `bash npm start -- --mode=rest --port=9593 --endpoint=/rest `

API Reference

Generate Image

Request Format:
`json { "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:
`json { "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:
`json { "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
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.