https://github.com/dasheck0/face-generator
MCP server for generating human face images with various shapes and sizes
https://github.com/dasheck0/face-generator
Last synced: 6 months ago
JSON representation
MCP server for generating human face images with various shapes and sizes
- Host: GitHub
- URL: https://github.com/dasheck0/face-generator
- Owner: dasheck0
- License: mit
- Created: 2024-12-28T13:25:06.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-03-13T15:22:26.000Z (7 months ago)
- Last Synced: 2025-03-22T04:33:57.819Z (7 months ago)
- Language: JavaScript
- Size: 14.6 KB
- Stars: 1
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- mcp-index - Face Generator - Generate realistic human face images with customizable shapes, sizes, and backgrounds. Supports batch generation for multiple images and offers transparent backgrounds for non-square outputs. (Content Creation)
README
# 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
```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