Face Generator MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • The MCP server can be installed and run via npm, the Node.js package manager, using the package @dasheck0/face-generator.

  • The MCP server supports generating face images in square shape (one of the available shape options alongside circle and rounded rectangle).

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Generates realistic human face images that don't represent real people, offering various output shapes, configurable dimensions, and batch generation capabilities.

  1. Features
    1. Installation
      1. Usage
        1. As an MCP Server
          1. Tool Parameters
          2. Example
            1. License