AI导哈

人脸生成服务

一个基于Model Context Protocol (MCP)的人脸图像生成服务，可集成到VS Code等开发工具中。

  • by dasheck0
  • JavaScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 dasheck0/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.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桌面：
      1. 打开GitHub桌面。
      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 Inspector is up and running at http://localhost:5173 🚀。这是您将用于在浏览器中打开MCP检查器的URL。

4.与Cline整合

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

  1. 安装Cline： 如果还没有，请在VS Code中安装“Cline”扩展。

  2. 打开临床设置：

    • 打开VS代码设置（文件->首选项->设置，或Ctrl+）。
    • 搜索“临床MCP设置”。
    • 点击“在settings.json中编辑”。这将打开 cline_mcp_settings.json 文件。

  3. 添加服务器配置： 您需要在 servers 数组中 cline_mcp_settings.json 文件。这里有一个例子：

    {
  "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代码。

6.刀具参数

这 generate_face 工具接受以下参数：

  • outputDir：（必填）保存图像的目录
  • fileName：可选文件名（默认为时间戳）
  • count：要生成的图像数量（默认值：1）
  • width：图像宽度（像素）（默认值：256）
  • height：图像高度（像素）（默认值：256）
  • shape：图像形状（方形|圆形|圆角，默认：方形）
  • borderRadius：圆角形状的边界半径（默认值：32）
  • returnImageContent：将图像作为base64编码的内容而不是文件路径返回（默认值：false）

示例

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

许可证

麻省理工学院

相关 MCP