人脸生成器 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 包管理器）随 Node.js 一起安装，用于安装包（代码库）。
  • 下载 Node.js。选择 LTS（长期支持）版本。 这是最稳定的版本。按照操作系统的安装说明进行操作。确保在安装过程中包含 npm（通常默认包含）。
  • 验证安装： 安装 Node.js 后，打开一个新的终端（Windows 上的命令提示符，macOS/Linux 上的终端）并输入：

    node -v
    npm -v
    

    你应该会看到 Node.js 和 npm 的版本号。如果看到错误，可能是 Node.js 未正确安装，或者它不在系统的 PATH 中。（请参阅下面的故障排除部分）。

2. 安装和设置

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

1. 克隆仓库：

   • 使用 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. 点击“克隆”。

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

   npm install
   

   这可能需要几分钟。

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

   npm run build
   

3. 运行服务器

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

• 独立模式： 直接运行服务器，它将在终端中输出消息。
• 开发/调试模式： 使用 MCP 检查器运行服务器。你可以在浏览器中打开它输出的 URL 并开始操作。

3.1 独立模式

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

npm run start

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

3.2 开发/调试模式（带检查器）

此模式对调试非常有用。

1. 在调试模式下启动服务器：

   npm run dev
   

   这将启动服务器并输出类似以下的消息：🔍 MCP 检查器已启动并运行于 http://localhost:5173 🚀。这是你将在浏览器中打开 MCP 检查器的 URL。

4. 与 Cline 集成

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

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

2. 打开 Cline 设置：

   • 打开 VS Code 设置（文件 -> 首选项 -> 设置，或 Ctrl+,）。
   • 搜索“Cline MCP 设置”。
   • 点击“在 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 服务器”面板中看到服务器出现（在 Cline 扩展中，你会在顶部找到不同的按钮）。
   • 让 Cline 生成一张人脸，它应该会提到 MCP 服务器，并尝试使用相应的工具。

5. 故障排除

• 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。

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