Face Generator MCP Server

Face Generator MCP 服务：轻松生成人脸

功能

此项目提供一个 MCP 服务，使用 https://thispersondoesnotexist.com 生成人脸图像。你可以把它看作一个工具，让 Cline 等其他应用按需生成逼真的人脸。

本指南面向初学者，将逐步介绍所有内容。我们会讲解：

1. 前置条件： 开始前需要准备什么。
2. 安装和设置： 安装并配置所有内容。
3. 运行服务： 启动服务。
4. 与 Cline 集成： 将此服务连接到 Cline VS Code 扩展。
5. 故障排除： 常见问题及解决方案。
6. 工具参数： generate_face 工具可用参数的列表。

1. 前置条件

开始之前，你需要准备以下内容：

• Node.js 和 npm： Node.js 是一种 JavaScript 运行时，可让你在 Web 浏览器之外运行 JavaScript 代码。npm（Node Package Manager）随 Node.js 一同提供，用于安装软件包（代码库）。
  • 下载 Node.js。请选择 LTS（长期支持）版本。 这是最稳定的版本。按照适用于你操作系统的安装说明进行操作。确保安装时包含 npm（通常默认会包含）。
  • 验证安装： 安装 Node.js 后，打开一个新的终端（Windows 上为命令提示符，macOS/Linux 上为 Terminal），并输入：

    node -v
    npm -v
    

    你应该会看到 Node.js 和 npm 的版本号。如果出现错误，可能是 Node.js 安装不正确，或未添加到系统的 PATH 中。（请参阅下文的“故障排除”。）

2. 安装和设置

获取项目代码并完成设置：

1. 克隆仓库：

   • 使用 Git（命令行）：
     1. 打开终端（命令提示符或 Terminal）。
     2. 转到你要存放项目的目录。例如，要将项目放到桌面上：

        cd Desktop
        

     3. 克隆仓库：

        git clone https://github.com/Moe/mcp-face-generator
        

     4. 进入项目目录：

        cd mcp-face-generator
        

   • 使用 GitHub Desktop：
     1. 打开 GitHub Desktop。
     2. 点击“File” -> “Clone Repository...”。
     3. 在“URL”选项卡中粘贴仓库 URL。
     4. 选择本地路径（即你要在电脑上保存项目的位置）。
     5. 点击“Clone”。

2. 安装依赖项： 这会下载项目所需的所有库。在终端中进入项目目录，然后运行：

   npm install
   

   这可能需要几分钟。

3. 构建项目： 这会将代码编译为可执行格式。

   npm run build
   

3. 运行服务

你可以通过两种主要方式运行服务：

• 独立模式： 直接运行服务，消息会输出到终端。
• 开发/调试模式： 使用 MCP Inspector 运行服务。你可以在浏览器中打开输出的 URL，开始尝试使用。

3.1 独立模式

要以独立模式运行服务，请在终端中（从项目目录）使用以下命令：

npm run start

你应该会在终端中看到表明服务正在运行的消息。它会监听来自 MCP 客户端的连接。服务会持续运行，直到你将其停止（通常按 Ctrl+C）。

3.2 开发／调试模式（使用 Inspector）

此模式适用于调试。

1. 以调试模式启动服务：

   npm run dev
   

   这会启动服务，并输出类似以下消息：🔍 MCP Inspector is up and running at http://localhost:5173 🚀。你可以使用此 URL 在浏览器中打开 MCP Inspector。

4. 与 Cline 集成

Cline 是一个 VS Code 扩展，使用 MCP 服务提供语言支持。以下介绍如何将此人脸生成器服务连接到 Cline：

1. **安装 Cline：**如果尚未安装，请在 VS Code 中安装“Cline”扩展。

2. 打开 Cline 设置：

   • 打开 VS Code 设置（文件 -> 首选项 -> 设置，或按 Ctrl+,）。
   • 搜索“Cline MCP Settings”。
   • 点击“在 settings.json 中编辑”。这会打开 cline_mcp_settings.json 文件。

3. **添加服务配置：**你需要在 cline_mcp_settings.json 文件的 servers 数组中添加一项。示例如下：

   {
     "mcpServers": {
       "face-generator": {
         "command": "node",
         "args": [
           "C:/PATH_TO/mcp-face-generator/build/index.js"
         ],
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

   • 将 "C:/PATH_TO/mcp-face-generator/build/index.js" 替换为项目目录中 index.js 文件的实际路径。在 Windows 上，路径中使用正斜杠（/）或双反斜杠（\\）。

4. 测试连接：

   • Cline 应该会自动连接到服务。你会在“MCP Servers”面板中看到该服务（在 Cline 扩展中，顶部有不同的按钮。）
   • 让 Cline 生成一张人脸，它应该会提及 MCP 服务，并尝试使用相应的工具。

5. 故障排除

• 运行 node -v 或 npm -v 时出错：
  • 确保 Node.js 已正确安装。尝试重新安装。
  • 确保 Node.js 安装目录已添加到系统的 PATH 环境变量中。在 Windows 上，你可以通过系统属性编辑环境变量（在开始菜单中搜索“环境变量”）。
• npm install 失败：
  • 确保已连接互联网。
  • 尝试删除 node_modules 文件夹，然后再次运行 npm install。
  • 如果你使用代理，可能需要配置 npm 使用代理。在线搜索“npm proxy settings”。
• Cline 无法连接到服务：
  • 再次检查 cline_mcp_settings.json 中的设置。路径必须是正确的 index.js 文件路径。
  • 确保服务正在运行（运行 npm run start 进行检查）。
  • 重启 VS Code。

6. 工具参数

generate_face 工具接受以下参数：

• outputDir： （必需）用于保存图像的目录
• fileName：可选文件名（默认为时间戳）
• count：要生成的图像数量（默认值：1）
• width：图像宽度，单位为像素（默认值：256）
• height：图像高度，单位为像素（默认值：256）
• shape：图像形状（square|circle|rounded，默认值：square）
• borderRadius：圆角形状的边框半径（默认值：32）
• returnImageContent：以 base64 编码内容而非文件路径的形式返回图像（默认值：false）

示例

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

许可证

MIT