MCP HubMCP Hub
husniadil

mcp-image-placeholder

by: husniadil

A lightweight MCP server for generating placeholder images from multiple providers.

6created 10/02/2025
Visit
lightweight
placeholder

📌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 is a Model Context Protocol (MCP) server that provides a tool for generating placeholder images from different providers.

Features

  • Generates placeholder images from supported providers
  • Supports two image providers:
  • 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:

  1. Add the following to your claude_desktop_config.json:
    {
        "mcpServers": {
            "image-placeholder": {
                "command": "uv",
                "args": [
                    "--directory",
                    "/ABSOLUTE/PATH/TO/PROJECT",
                    "run",
                    "main.py"
                ]
            }
        }
    }
    
  2. Restart Claude for Desktop

To connect this server to Cursor:

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

Troubleshooting

If the tool is not detected, use absolute path of the uv command, e.g.

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

License

MIT License