Skip to main content
Glama
MCP Image Placeholder Server

MCP Image Placeholder Server

by husniadil

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

Related MCP server: Grok AI Image Generation MCP Server

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

Example Usage and Output (Cursor)

Prompt:

Create a new directory named "example" and a file named output.html.

Then create a single modern looking page using tailwindcss: https://unpkg.com/@tailwindcss/browser@4

Show a nice header, content, and footer, showing a photo gallery.

Save this into output.html

Screenshot of Cursor Agent

Output: Example Output (Cursor)

License

MIT License

Available Tools

1 tool
image_placeholderA
Generate a placeholder image based on a provider, width, and height.
Use this tool to generate a placeholder image for testing or development purposes.

Args:
    provider: The provider to use for the image, must be either `placehold` or `lorem-picsum`.
    width: The width of the image, must be a positive integer between 1 and 10000.
    height: The height of the image, must be a positive integer between 1 and 10000.

Inputs: provider (required), width (required), height (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap with other tools. The tool's purpose is clearly defined and distinct by default.

    Naming Consistency5/5

    The single tool name 'image_placeholder' follows a clear and consistent verb_noun pattern. Since there is only one tool, naming consistency is inherently perfect.

    Tool Count2/5

    A single tool for an image placeholder server feels thin and limited in scope. While it serves a specific purpose, it lacks related operations like listing available providers or generating images with additional parameters, making it borderline too few for practical use.

    Completeness3/5

    The tool covers the core functionality of generating placeholder images with basic parameters. However, there are notable gaps, such as no tools for retrieving image metadata, managing providers, or handling errors beyond parameter validation, which limits the server's utility.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      This server provides tools for uploading images and videos directly to Cloudinary using Claude/Cline, facilitating resource management with customizable options like resource type and public ID.
      1
      10
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables image generation and retrieval from picsum.photos with customizable parameters like dimensions, filters, and output formats.
      1
      -