mcp-image-placeholder
by: husniadil
A lightweight MCP server for generating placeholder images from multiple providers.
📌Overview
Purpose: The MCP Image Placeholder Server aims to generate placeholder images from various providers, allowing developers to easily integrate image generation into their applications.
Overview: This server utilizes the Model Context Protocol (MCP) to serve as a tool for creating placeholder images that can be fetched based on specified parameters like size and provider. It supports two primary image providers and validates input to ensure a smooth user experience.
Key Features:
-
Image Generation from Multiple Providers: Utilizes
placehold
for simple placeholder images andlorem-picsum
for real images, offering flexibility based on user needs. -
Input Validation: Ensures that parameters for image size and provider are correctly formatted, reducing the likelihood of errors during image generation.
-
Immediate URL Return: Provides instant access to generated image URLs, allowing for swift integration into projects.
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 images
- lorem-picsum: Provides real images as placeholder images
- Validates input parameters
- Returns image URLs for immediate use
Requirements
- Python 3.9+
uv
package manager
Installation
- Clone this repository
- 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
orlorem-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 Features section
- Scroll down to the MCP Servers section
- Click on the Add new MCP server button
- Enter the following information:
- Name:
image-placeholder
- Type:
command
- Server URL:
uv --directory /ABSOLUTE/PATH/TO/PROJECT run main.py
- Name:
- 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
License
MIT License