Image Generation (Replicate)

🚀 Image Generator MCP Server

This is an MCP server for image generation using Replicate, allowing users to save the generated images.

🚀 Quick Start

📦 Installation

Claude Desktop

• On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• On Windows: %APPDATA%/Claude/claude_desktop_config.json%

✨ Features

🔍 Resources

The server implements an image storage system with the following features:

• Uses a custom image:// URI scheme to access individual generated images.
• Each image resource has a name based on its prompt, a description containing the creation date, and a MIME type of image/png.

💬 Prompts

The server provides a single prompt:

• generate-image: Used to generate images with Stable Diffusion.
  • An optional "style" parameter to control the image style (realistic/artistic/abstract).
  • Generates a prompt template with style-specific guidance.

🛠️ Tools

The server implements three tools:

• generate-image: Generates an image using Replicate's Stable Diffusion model.
  • Accepts "prompt" as a required string parameter.
  • Optional parameters include "negative_prompt", "width", "height", "num_inference_steps", and "guidance_scale".
  • Returns the generated image and its URL.
• save-image: Saves the generated image to the local file system.
  • Accepts "image_url" and "prompt" as required string parameters.
  • Generates a unique ID for the image and saves it to the "generated_images" directory.
• list-saved-images: Lists all saved images.
  • Returns a list of all saved images, including their metadata and thumbnails.

📚 Documentation

Replicate API Token

To use this image generator, you need a Replicate API Token:

1. Create an account on Replicate.
2. Get your API Token from https://replicate.com/account.
3. Create a .env file based on the provided .env.example template:

REPLICATE_API_TOKEN=your_replicate_api_token_here

⚠️ Important Note

The .env file is excluded from version control via .gitignore to prevent accidental exposure of your API Token. Never commit sensitive information to your repository.

Environment Setup

1. Clone the repository:

git clone https://github.com/yourusername/image-generator.git
cd image-generator

2. Create and activate a virtual environment:

# Using venv
python -m venv .venv
# On Windows
.venv\Scripts\activate
# On macOS/Linux
source .venv/bin/activate

3. Install dependencies:

pip install -r requirements.txt

4. Set up your .env file as described above.