Face Generator

🚀 Face Generation MCP Server

A Model Context Protocol (MCP) server that uses https://thispersondoesnotexist.com to generate human face images.

🚀 Quick Start

This is a Model Context Protocol (MCP) server that can generate human face images using the resources from https://thispersondoesnotexist.com.

✨ Features

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

📦 Installation

npm install @dasheck0/face-generator

💻 Usage Examples

Basic Usage

Run as an MCP Server

1. Start the server:

npx face-generator

2. Use an MCP client to call the generate_face tool.

Advanced Usage

Tool Parameters

• outputDir: (Required) The directory to save the images.
• fileName: Optional file name (default: timestamp).
• count: The 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: The border radius for rounded rectangles (default: 32).

Example Configuration

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

📄 License

This project is licensed under the MIT license.