面部生成器

Name: 面部生成器
Author: dasheck0

作者：dasheck05 星标更新：2025-07-07

项目介绍

该项目提供了一个使用 https://thispersondoesnotexist.com 生成人脸图像的 Model Context Protocol (MCP) 服务器。可以将其视为一个工具，让其他应用程序（如 Cline）按需生成逼真的面孔。

本指南面向初学者，我们将逐步介绍以下内容：

在开始之前，你需要准备一些东西：

Node.js 和 npm： Node.js 是一种允许你在浏览器之外运行 JavaScript 代码的 JavaScript 运行时环境。npm（Node 包管理器）随 Node.js 一起提供，用于安装包（代码库）。
- 下载 Node.js。选择 LTS（长期支持）版本。 这是最稳定的版本。按照你的操作系统安装说明进行操作。确保安装时包含 npm（通常默认包含）。
- 验证安装： 安装 Node.js 后，在新的终端（Windows 上的命令提示符，macOS/Linux 上的终端）中键入：
```
node -v
npm -v
```
  你应该看到 Node.js 和 npm 的版本号。如果看到错误，可能是因为 Node.js 没有正确安装，或者它不在系统的 PATH 中。（参见下面的故障排除部分）。

让我们获取项目代码并进行设置：

克隆仓库：
- 使用 Git（命令行）：
  1. 打开终端（命令提示符或终端）。
  2. 导航到你希望存储项目的目录。例如，要将其放在桌面上：
```
cd Desktop
```
  3. 克隆仓库：
```
git clone https://github.com/Moe/mcp-face-generator
```
  4. 切换到项目目录：
```
cd mcp-face-generator
```
- 使用 GitHub Desktop：
  1. 打开 GitHub Desktop。
  2. 点击“文件”->“克隆仓库...”。
  3. 在“URL”标签页中粘贴仓库 URL。
  4. 选择本地路径（你希望在计算机上保存项目的路径）。
  5. 点击“克隆”。
安装依赖项： 这会下载项目所需的所有必要库。在终端中的项目目录内运行：
```
npm install
```
这可能需要几分钟时间。
构建项目： 这会将代码编译成可执行格式。
```
npm run build
```

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

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

npm run start

你应该会在终端看到指示服务器正在运行的消息。它会监听来自 MCP 客户端的连接。除非你停止它（通常使用 Ctrl+C），否则服务器将继续运行。

这种模式对于调试非常有用。

以调试模式启动服务器：
```
npm run dev
```
这将启动服务器并输出类似这样的消息：🔍 MCP Inspector 正在 http://localhost:5173 🚀 运行。这就是你要在浏览器中打开 MCP Inspector 的 URL。

Cline 是一个使用 MCP 服务器提供语言支持的 VS Code 扩展。以下是将此面部生成器服务器连接到 Cline 的方法：

安装 Cline： 如果还没有安装，请在 VS Code 中安装“Cline”扩展。
打开 Cline 设置：
- 打开 VS Code 设置（文件 -> 首选项 -> 设置，或 Ctrl+,）。
- 搜索“Cline MCP 设置”。
- 点击“在 settings.json 中编辑”。这将打开 cline_mcp_settings.json 文件。
添加服务器配置： 你需要在 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 上使用正斜杠 (/) 或双反斜杠 (\) 来表示路径。
测试连接：
- Cline 应该自动连接到服务器。你会在“MCP 服务器”面板中看到服务器（在 Cline 扩展中，顶部会有不同的按钮）。
- 请求 Cline 生成一张脸，它应该提到 MCP 服务器并尝试使用相应的工具。

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

generate_face 工具接受以下参数：

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

MIT