Labsco
MCP SERVER

MCP Image Placeholder Server

by husniadil

Get a placeholder image URL at any size from either a plain grey generator or a real-photo service, validated before it is returned.

Developer Conversions, Encoding & Test Data
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`, a `width` and a `height` — `image_placeholder`
  • Two providers behind the same call: `placehold` for simple blocks, `lorem-picsum` for 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.