EverArt Forge MCP 使用说明

项目简介

EverArt Forge MCP 是一个专为 Cline 设计的 Model Context Protocol (MCP) 服务器，它集成了 EverArt 的 AI 模型，能够生成高质量的矢量图和栅格图。该服务器提供强大的图像生成能力，并支持灵活的存储选项和格式转换，方便用户在本地管理和使用生成的图像资源。

主要功能点

图像生成: 利用 EverArt 提供的多种 AI 模型，根据文本提示生成矢量 (SVG) 和栅格 (PNG, JPEG, WebP) 图像。
模型选择: 支持多种 EverArt 模型，包括用于生成通用图像的 FLUX1.1 系列、Stable Diffusion 3.5 以及专门用于矢量图和照片写实风格的模型。
灵活存储: 允许用户自定义图像的输出路径和文件名，并能自动创建目录，方便集成到 Web 项目中。
资源管理: 提供工具列出和查看已生成的图像资源，方便用户管理和使用。
格式转换和优化: 自动优化 SVG 矢量图，并支持将栅格图转换为 PNG, JPEG, WebP 等格式。

安装步骤

克隆仓库:

git clone https://github.com/nickbaumann98/everart-forge-mcp.git
cd everart-forge-mcp

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```
获取 EverArt API 密钥:
- 访问 EverArt 注册账号。
- 登录后，在账号设置中创建或复制 API 密钥。

配置 Cline MCP 设置: 根据你使用的 Cline 客户端（VS Code 扩展或 Claude 桌面应用），编辑相应的配置文件，添加 EverArt Forge MCP 服务器配置。

VS Code 扩展配置示例 ('~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json'):

{
  "mcpServers": {
    "everart-forge": {
      "command": "node",
      "args": ["/absolute/path/to/everart-forge-mcp/build/index.js"],
      "env": {
        "EVERART_API_KEY": "your_api_key_here"  // 替换为你的 EverArt API 密钥
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

** Claude 桌面应用配置示例 ('~/Library/Application Support/Claude/claude_desktop_config.json' 或操作系统对应的配置路径)**:

{
  "mcpServers": {
    "everart-forge": {
      "command": "node",
      "args": ["/absolute/path/to/everart-forge-mcp/build/index.js"],
      "env": {
        "EVERART_API_KEY": "your_api_key_here"  // 替换为你的 EverArt API 密钥
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

注意:

将 '/absolute/path/to/everart-forge-mcp/build/index.js' 替换为 'everart-forge-mcp' 仓库 'build/index.js' 文件的绝对路径。
将 '"your_api_key_here"' 替换为你从 EverArt 官网获取的 API 密钥。

重启 Cline 客户端: 重启 Cline 客户端以加载新的 MCP 服务器配置。

服务器配置

以下是在 Cline 客户端中配置 EverArt Forge MCP 服务器的 JSON 格式配置信息：

{
  "server name": "everart-forge",  // 服务器名称，在 Cline 客户端中用于标识和选择该服务器
  "command": "node",  // 启动服务器的命令，这里使用 Node.js 运行 JavaScript 文件
  "args": ["/absolute/path/to/everart-forge-mcp/build/index.js"],  // 启动命令的参数，指向服务器入口文件 build/index.js 的绝对路径
  "env": {
    "EVERART_API_KEY": "your_api_key_here"  // 环境变量，用于传递 EverArt API 密钥，请替换为你的真实密钥
  },
  "disabled": false,  // 设置为 false 表示启用该服务器，true 则禁用
  "autoApprove": []   // 自动批准的工具列表，留空表示需要手动批准工具调用
}

基本使用方法

配置完成后，在 Cline 客户端中，你可以使用以下工具与 EverArt Forge MCP 服务器交互：

generate_image: 生成图像。
- 在 Cline 中输入自然语言指令，例如: '"使用 Recraft-Vector 模型生成一个 SVG 格式的科技 лого"'。
- 可以使用参数更详细地控制图像生成，例如指定模型、格式、输出路径等。
list_images: 列出所有已存储的图像文件。
- 在 Cline 中输入指令调用该工具，服务器会返回已存储图像的文件名列表。
view_image: 在默认图像查看器中打开指定的图像文件。
- 输入指令并指定要查看的图像文件名，服务器会在本地打开该图像。

使用示例:

'"Generate a minimalist tech logo in SVG format using the Recraft-Vector model"' (生成一个使用 Recraft-Vector 模型，SVG 格式的极简科技 лого)
'"Create a photorealistic landscape image with the FLUX1.1-ultra model"' (使用 FLUX1.1-ultra 模型创建一个照片写实风格的风景图像)
'"List all generated images"' (列出所有生成的图像)
'"View image filename: 2024-08-03T10-30-00_8000_tech_logo.svg"' (查看名为 "2024-08-03T10-30-00_8000_tech_logo.svg" 的图像)

关键词