# Face Generator MCP Server
A Model Context Protocol (MCP) server for generating human face images using https://thispersondoesnotexist.com.
<a href="https://glama.ai/mcp/servers/0v6oomxing">
<img width="380" height="200" src="https://glama.ai/mcp/servers/0v6oomxing/badge" alt="Face Generator Server MCP server" />
</a>
## 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
```bash
npm install @dasheck0/face-generator
```
## Usage
### As an MCP Server
1. Start the server:
```bash
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
```json
{
"outputDir": "./output",
"count": 3,
"width": 512,
"height": 512,
"shape": "circle"
}
```
## License
MIT