MCP Image Placeholder Server
This server allows you to generate placeholder images for testing or development purposes with customizable dimensions.
Multiple Providers: Choose either
placeholdorlorem-picsumto generate imagesCustomizable Dimensions: Specify width and height (1-10000 pixels)
Return Image URLs: Get immediate URLs for the generated images
Referenced in an example usage where tailwindcss is loaded from unpkg.com for creating a modern page with a photo gallery
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Image Placeholder Server generate a 400x300 placeholder image for my website mockup"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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:
placehold: Provides simple placeholder imageslorem-picsum: Provides real images as placeholder images
Validates input parameters
Returns image URLs for immediate use
Related MCP server: Grok AI Image Generation MCP Server
Requirements
Python 3.9+
uvpackage manager
Installation
Clone this repository
Usage
The server exposes one tool:
image_placeholder
Generate a placeholder image URL based on specified parameters.
Parameters:
provider: The image provider to use (placeholdorlorem-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:
Open Cursor Settings
Head to the
FeaturessectionScroll down to the
MCP ServerssectionClick on the
Add new MCP serverbuttonEnter the following information:
Name:
image-placeholderType:
commandServer URL:
uv --directory /ABSOLUTE/PATH/TO/PROJECT run main.py
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.pyExample 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
Available Tools
1 toolimage_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
Scored across 1 tool
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.
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.
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.
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
Related MCP Connectors
Generate images from Claude, ChatGPT, Cursor and Codex with 12 top AI image models. Up to 4 images per call, SVG vectorization, background removal, upscaling and image-to-video. Remote MCP with OAuth, no API keys.
Generate images from Claude, ChatGPT, Cursor and Codex with 12 top AI image models and 10 tools: up to 4 images per call, SVG vectorization, editing and more. Remote MCP with OAuth, no API keys. Pay per image, no subscription.
Generate deterministic placeholder image URLs and packs for docs, staging, testing, and AI agents.
Focused MCP server for OpenAI image/audio generation (v2.0.0). Wraps endpoints via HAPI CLI.
Related MCP Servers
- AlicenseBqualityDmaintenanceThis 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.110MIT
- FlicenseNot gradedqualityDmaintenanceA server that connects to the xAI/Grok image generation API, allowing users to generate images from text prompts with support for multiple image generation and different response formats.-
- AlicenseCqualityDmaintenanceA server that accepts image URLs and analyzes their content using GPT-4-turbo, enabling Claude AI assistants to understand and describe images through natural language.28MIT
- FlicenseBqualityDmaintenanceA Model Context Protocol server that enables image generation and retrieval from picsum.photos with customizable parameters like dimensions, filters, and output formats.1-