MCP Image Placeholder Server

by husniadil

Integrations

  • Referenced in an example usage where tailwindcss is loaded from unpkg.com for creating a modern page with a photo gallery

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

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

Output: Example Output (Cursor)

License

MIT License

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

This server generates placeholder image URLs from various providers, supporting input validation and integration with desktop applications like Claude and Cursor.

  1. Features
    1. Requirements
      1. Installation
        1. Usage
          1. image_placeholder
        2. Configuration
          1. To connect this server to Claude for Desktop:
          2. To connect this server to Cursor:
        3. Troubleshooting
          1. Example Usage and Output (Cursor)
            1. License

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                Provides HTML file preview and analysis capabilities. This server enables capturing full-page screenshots of local HTML files and analyzing their structure.
                Last updated -
                2
                8
                JavaScript
                MIT License
              • A
                security
                F
                license
                A
                quality
                A Model Context Protocol server that provides image generation capabilities using the Ideogram API, allowing users to create images from text prompts with customizable parameters.
                Last updated -
                1
                1
                3
                JavaScript
              • A
                security
                A
                license
                A
                quality
                A lightweight server that enables seamless integration with Unsplash's image library, allowing developers to search for high-quality photos with various filters directly from the Cursor editor.
                Last updated -
                1
                112
                Python
                MIT License
              • -
                security
                A
                license
                -
                quality
                A server that integrates with Claude Desktop to enable real-time web research capabilities, allowing users to search Google, extract webpage content, and capture screenshots directly from conversations.
                Last updated -
                854
                MIT License
                • Apple

              View all related MCP servers

              ID: pye2qsv1wz