Skip to main content
Glama

Image Generator MCP Server

A Model Context Protocol (MCP) server that generates test images with customizable width, height, and color. Saves images as PNG files to specified file paths.

Features

  • Generate test images with specified dimensions (1-4096 pixels)

  • Support for hex color format (e.g., #FF0000, #f00)

  • Automatic text overlay showing image dimensions

  • Optional custom label text displayed in the top-left corner

  • Smart contrast color selection for readable text

  • Saves images as PNG files to specified file paths

  • Automatically creates directories if they don't exist

Installation

  1. Clone or download this repository

  2. Install dependencies:

npm install
  1. Build the server:

npm run build
  1. Add the server to your MCP configuration:

For VSCode:

{ "servers": { "Image Placeholder Gen": { "type": "stdio", "command": "node", "args": [ "~/mcp_servers/image-gen/build/index.js" ] } } }

For Claude Desktop:

{ "mcpServers": { "image-gen": { "command": "node", "args": ["/path/to/image-gen/build/index.js"] } } }

Usage

The server provides one tool:

generate_test_image

Generate a test image with specified parameters.

Parameters:

  • width (number): Width of the image in pixels (1-4096)

  • height (number): Height of the image in pixels (1-4096)

  • color (string): Color of the image as hex code (e.g., #FF0000 or #f00)

  • filepath (string): Full path where the PNG image should be saved

  • label (string, optional): Custom text to display in the top-left corner of the image

Example:

{ "name": "generate_test_image", "arguments": { "width": 400, "height": 300, "color": "#3498db", "filepath": "/tmp/test_image.png", "label": "My Custom Label" } }

Returns:

  • Text confirmation that the image was successfully generated and saved

Color Format

The tool supports hex color format:

  • Hex colors: #FF0000, #f00

Testing

Run the test script to verify the server works:

npm run build npm test

Dependencies

  • Node.js canvas library for image generation

  • Model Context Protocol SDK

Notes

  • Maximum image dimensions are capped at 4096x4096 pixels for performance

  • Generated images include dimension text overlay for easy identification

  • Text color is automatically chosen for optimal contrast against the background

  • The server automatically creates directories if they don't exist in the specified file path

Contributing

Feel free to submit issues and enhancement requests!

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sam2332/Mcp-Server-Placeholder-Image-Generator'

If you have feedback or need assistance with the MCP directory API, please join our Discord server