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

Start the server:

npx face-generator

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