使用说明

项目简介

Face Generator MCP服务器是一个基于 Model Context Protocol (MCP) 的后端应用，它提供了一个名为 'generate_face' 的工具，允许 MCP 客户端（如LLM应用）调用该工具生成人脸图片。图片来源于 thispersondoesnotexist.com 网站，并支持自定义图片尺寸、形状和数量。

主要功能点

生成人脸图片: 从 thispersondoesnotexist.com 获取人脸图片。
多种输出形状: 支持生成方形、圆形或圆角矩形的人脸图片。
可配置的图片尺寸: 可以自定义生成图片的宽度和高度。
批量生成: 支持一次性生成多张人脸图片。
透明背景: 对于圆形和圆角矩形形状，图片背景为透明。

安装步骤

确保已安装 Node.js 和 npm。

打开终端，执行以下命令安装 'face-generator' 包：

npm install @dasheck0/face-generator

服务器配置

MCP 客户端需要配置以下信息以连接到 Face Generator MCP 服务器。

{
  "serverName": "face-generator",
  "command": "npx",
  "args": ["face-generator"]
}

'serverName': 服务器名称，可以自定义，用于在 MCP 客户端中标识该服务器。
'command': 启动服务器的命令，这里使用 'npx' 来运行本地安装的 'face-generator' 包。
'args': 启动命令的参数，这里为空数组，因为 'face-generator' 服务器启动不需要额外的命令行参数。

基本使用方法

启动服务器: 在安装 'face-generator' 的项目目录下，MCP 服务器会在安装后自动注册为可执行命令。当 MCP 客户端尝试连接时，会自动启动服务器。你也可以手动在终端执行 'npx face-generator' 命令来提前启动服务器。服务器启动后，会在控制台输出 'Face Generator MCP server running on stdio'，表示服务器已在标准输入/输出流上运行并等待客户端连接。

通过 MCP 客户端调用 'generate_face' 工具: 在 MCP 客户端中，可以使用 'generate_face' 工具生成人脸图片。你需要提供工具所需的参数，例如 'outputDir' (图片保存目录) 等。以下是一个调用 'generate_face' 工具的示例参数：

{
  "name": "generate_face",
  "arguments": {
    "outputDir": "./output",  // 图片保存目录，请确保目录存在或有创建权限
    "fileName": "my_face",   // 可选，文件名，默认为时间戳
    "count": 2,             // 可选，生成图片数量，默认为 1
    "width": 512,           // 可选，图片宽度，默认为 256
    "height": 512,          // 可选，图片高度，默认为 256
    "shape": "circle"       // 可选，图片形状，可选值：square, circle, rounded，默认为 square
    // "borderRadius": 64    // 可选，圆角矩形边框半径，当 shape 为 rounded 时生效，默认为 32
  }
}

MCP 客户端发送调用工具的请求后，Face Generator MCP 服务器会生成指定数量的人脸图片，并保存到 'outputDir' 目录中。服务器会返回包含生成图片路径的响应。

关键词