Face Generator MCP Server

A Model Context Protocol (MCP) server for generating human face images using https://thispersondoesnotexist.com.

Features

• Generate human face images
• Multiple output shapes: square, circle, rounded rectangle
• Configurable image dimensions
• Transparent backgrounds for non-square shapes
• Batch generation of multiple images

Installation

npm install @dasheck0/face-generator

Usage

As an MCP Server

1. Start the server:

npx face-generator

2. Use the generate_face tool through an MCP client.

Tool Parameters

• outputDir: (required) Directory to save the images
• fileName: Optional file name (defaults to timestamp)
• count: Number of images to generate (default: 1)
• width: Image width in pixels (default: 256)
• height: Image height in pixels (default: 256)
• shape: Image shape (square|circle|rounded, default: square)
• borderRadius: Border radius for rounded shape (default: 32)

Example

{
  "outputDir": "./output",
  "count": 3,
  "width": 512,
  "height": 512,
  "shape": "circle"
}

License

MIT