Face Generator MCP Server

What is Face Generator MCP Server?

Face Generator MCP Server is a Model Context Protocol (MCP) server that generates realistic human face images on demand by fetching them from thispersondoesnotexist.com. It is designed for integration with MCP clients like the Cline VS Code extension, allowing those tools to create face images programmatically.

How to use Face Generator MCP Server?

Clone the repository, run npm install and npm run build, then start the server with npm run start (standalone) or npm run dev (development/debug mode with Inspector). For Cline integration, add the server configuration to cline_mcp_settings.json pointing to build/index.js.

Key features of Face Generator MCP Server

• Uses thispersondoesnotexist.com to generate realistic faces
• Configurable image count, dimensions, and shape
• Supports square, circle, and rounded shapes
• Can return images as base64 content or file paths
• Easy integration with Cline VS Code extension
• Beginner‑friendly setup and documentation

Use cases of Face Generator MCP Server

• Generate placeholder faces for UI mockups or design projects
• Provide on‑demand face images for AI‑assisted coding tools like Cline
• Create batches of unique face images for testing or data augmentation

FAQ from Face Generator MCP Server

What are the prerequisites?

Node.js (LTS version) and npm are required. Verify installation with node -v and npm -v.

How do I integrate this server with Cline?

Add an entry to cline_mcp_settings.json with the command node and the argument "C:/PATH_TO/mcp-face-generator/build/index.js" (adjust the path). Restart VS Code and the server should appear in the MCP Servers panel.

What parameters does the generate_face tool accept?

outputDir (required), fileName, count (default 1), width (default 256), height (default 256), shape (square|circle|rounded, default square), borderRadius (default 32), and returnImageContent (boolean, default false).

What if npm install fails?

Ensure you have an internet connection. Try deleting the node_modules folder and running npm install again. If behind a proxy, configure npm proxy settings.

Why isn’t Cline connecting to the server?

Double‑check the path in cline_mcp_settings.json, make sure the server is running (npm run start), and restart VS Code.