人脸生成器MCP服务器：轻松生成人脸
特性
该项目提供了一个模型上下文协议（MCP）服务器，用于使用https://thispersondoesnotexist.com.将其视为一种工具，可以让其他应用程序（如Cline）根据需要生成逼真的面孔。
本指南是为初学者设计的，所以我们将一步一步地完成所有内容。我们将介绍：
- 先决条件： 开始前你需要什么。
- 安装和设置： 让一切启动并运行。
- 运行服务器： 正在启动服务器。
- 与Cline整合： 将此服务器连接到Cline VS Code扩展。
- 故障排除： 常见问题及解决方法。
- 刀具参数： 您可以使用的参数列表
generate_face工具。
1.先决条件
在开始之前，你需要一些东西：
- Node.js和npm： Node.js是一个JavaScript运行时环境，允许您在web浏览器之外运行JavaScript代码。npm（节点包管理器）包含在Node.js中，用于安装包（代码库）。
- . 选择LTS（长期支持）版本。 这是最稳定的版本。按照操作系统的安装说明进行操作。确保在安装中包含npm（默认情况下通常包含）。 - 验证安装： 安装Node.js后，打开一个新的终端（Windows上的命令提示符，macOS/Linux上的终端），然后键入：
node -v
npm -v你应该看到Node.js和npm的版本号。如果您看到错误，则可能是Node.js安装不正确，或者它可能不在系统的PATH中。（请参阅下面的故障排除）。
2.安装和设置
让我们获取项目代码并进行设置：
- 克隆存储库：
- 使用Git（命令行）： 1. 打开终端（命令提示符或终端）。 1. 导航到要存储项目的目录。例如，要将其放在桌面上：
cd Desktop1. 克隆存储库：
git clone https://github.com/Moe/mcp-face-generator1. 切换到项目目录：
cd mcp-face-generator- 使用GitHub桌面： 1. 打开GitHub桌面。 1. 单击“文件”->“克隆存储库…”。 1. 在“URL”选项卡中，粘贴存储库URL。 1. 选择本地路径（要在计算机上保存项目的位置）。 1. 单击“克隆”。
- 安装依赖关系： 这将下载项目所需的所有必要库。在终端的项目目录中，运行：
npm install这可能需要几分钟的时间。
- 构建项目： 这将代码编译为可执行格式。
npm run build3.运行服务器
您可以通过两种主要方式运行服务器：
- 独立模式： 这将直接运行服务器，并将消息输出到终端。
- 开发/调试模式： 这将使用MCP检查器运行服务器。您可以在浏览器中打开它输出的URL并开始播放。
3.1独立模式
要在独立模式下运行服务器，请在终端中（从项目目录）使用以下命令：
npm run start您应该在终端中看到消息，指示服务器正在运行。它将监听来自MCP客户端的连接。服务器将一直运行，直到您停止它（通常使用Ctrl+C）。
3.2开发/调试模式（带检查器）
此模式对调试很有用。
- 在调试模式下启动服务器：
npm run dev这将启动服务器并输出如下消息： 🔍 MCP Inspector is up and running at http://localhost:5173 🚀。这是您将用于在浏览器中打开MCP检查器的URL。
4.与Cline整合
Cline是一个VS Code扩展，它使用MCP服务器提供语言支持。以下是如何将此面部生成器服务器连接到Cline：
- 安装Cline： 如果还没有，请在VS Code中安装“Cline”扩展。
- 打开临床设置：
- 打开VS代码设置（文件->首选项->设置，或Ctrl+）。 - 搜索“临床MCP设置”。 - 点击“在settings.json中编辑”。这将打开 cline_mcp_settings.json 文件。
- 添加服务器配置： 您需要在
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上对路径使用正斜杠（/）或双反斜杠（\\\\）。
- 测试连接：
- 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
}许可证
麻省理工学院