image_placeholderLABSCO SUMMARY
One tool, and it removes a real interruption.
When an assistant is generating a page it otherwise invents image URLs that do not resolve. This gives it a validated one instead, and the choice between a flat placeholder and a real photograph changes how a mockup reads. Nothing more than that — a small tool that is honest about being small.
What it is
A one-tool MCP server for the small chore that interrupts every mockup: getting an image URL of the right dimensions. It supports two providers with different characters — placehold for plain placeholder blocks, lorem-picsum for real photographs — validates the dimensions, and returns a URL you can paste straight into markup.
What you get
- A placeholder image URL built from a
provider, awidthand aheight—image_placeholder - Two providers behind the same call:
placeholdfor simple blocks,lorem-picsumfor real images - Dimensions validated on the way in — width and height accept 1 to 10000
- A plain URL string back, ready to drop into HTML with no download step
Requirements
No account and no key. Python 3.9+ and the uv package manager; clone the repository and point your client at it with uv --directory /ABSOLUTE/PATH/TO/PROJECT run main.py. If the tool does not show up, use the absolute path to the uv binary as well — that is the documented fix.
Setup effort
Clone and run — clone the repository, then add the configuration for your client; uv runs the script from your clone, with nothing to build
USE CASES
01
Generating a page mockup that actually renders
Let the assistant request correctly sized placeholder URLs while it writes the markup, instead of inventing image links that do not resolve.
02
Making a gallery layout look real
Ask for the photo provider so the grid is filled with actual images and the spacing reads the way it will in production.
03
Checking a responsive layout at several sizes
Request the same provider at different widths and heights to see how the container behaves.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
Python 3.9+
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Clone the repository, then add the configuration for your client; uv runs the script from your clone, with nothing to build.
Server setup
TERMINAL
git clone https://github.com/husniadil/mcp-image-placeholder.gitMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"image-placeholder": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_PROJECT>",
"run",
"main.py"
]
}
}
}Cursor
CURSOR · JSON
{
"mcpServers": {
"image-placeholder": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_PROJECT>",
"run",
"main.py"
]
}
}
}Add this to Cursor's mcp.json. <YOUR_PATH_TO_PROJECT> is the absolute path of your clone. If the tool is not detected, use the absolute path of uv as the command.
