face-generator

face-generator

4
entertainment_and_media

The Face Generator MCP Server is designed to generate human face images using an online service. It supports various image shapes and dimensions and allows for batch image creation, making it useful for different applications requiring face generation.

Face Generator MCP Server

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

Face Generator Server MCP server

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
  1. 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