📌Overview

Purpose: The MCP Image Placeholder Server aims to generate placeholder images from various providers, allowing developers to easily integrate image generation into their applications.

Overview: This server utilizes the Model Context Protocol (MCP) to serve as a tool for creating placeholder images that can be fetched based on specified parameters like size and provider. It supports two primary image providers and validates input to ensure a smooth user experience.

Key Features:

• Image Generation from Multiple Providers: Utilizes placehold for simple placeholder images and lorem-picsum for real images, offering flexibility based on user needs.

• Input Validation: Ensures that parameters for image size and provider are correctly formatted, reducing the likelihood of errors during image generation.

• Immediate URL Return: Provides instant access to generated image URLs, allowing for swift integration into projects.

---

MCP Image Placeholder Server

This Model Context Protocol (MCP) server generates placeholder images from different providers.

Features

• Generates placeholder images from supported providers
• Supports two image providers:
  • placehold: Simple placeholder images
  • lorem-picsum: Real images as placeholders
• Validates input parameters
• Returns image URLs for immediate use

Requirements

• Python 3.9+
• uv package manager

Installation

1. Clone this repository
2. Set up the configuration for MCP server

Usage

The server exposes one tool:

image_placeholder

Generate a placeholder image URL based on specified parameters.

Parameters:

• provider: The image provider to use (placehold or lorem-picsum)
• width: The width of the image (1-10000)
• height: The height of the image (1-10000)

Returns:

• URL string of the generated image

Example Usage:

# Generate a 300x200 placeholder image
url = image_placeholder(provider="placehold", width=300, height=200)

# Generate a 500px square lorem-picsum image
url = image_placeholder(provider="lorem-picsum", width=500)

Configuration

To connect this server to Claude for Desktop:

Add the following to your claude_desktop_config.json:

{
    "mcpServers": {
        "image-placeholder": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PROJECT",
                "run",
                "main.py"
            ]
        }
    }
}

Restart Claude for Desktop.

To connect this server to Cursor:

1. Open Cursor Settings
2. Go to the Features section
3. Scroll down to the MCP Servers section
4. Click on Add new MCP server
5. Enter the following information:
   • Name: image-placeholder
   • Type: command
   • Server URL: uv --directory /ABSOLUTE/PATH/TO/PROJECT run main.py
6. Click Add

Troubleshooting

If the tool is not detected, use the absolute path of the uv command:

/ABSOLUTE/PATH/TO/uv --directory /ABSOLUTE/PATH/TO/PROJECT run main.py

License

MIT License