使用说明

项目简介

Replicate Flux MCP 服务器是一个实现了 Model Context Protocol (MCP) 的后端服务,旨在为 AI 助手提供高质量的图像和 SVG 矢量图形生成能力。它利用 Replicate API 接入 Black Forest Labs 的 Flux Schnell 模型(用于生成位图图像)和 Recraft 的 V3 SVG 模型(用于生成矢量图形)。通过此服务器,您的 AI 助手可以轻松调用图像和 SVG 生成工具,并管理生成历史记录。

主要功能点

  • 高质量图像生成: 使用 Flux Schnell 模型根据文本提示生成高质量图像。
  • SVG 矢量图形生成: 使用 Recraft V3 SVG 模型根据文本提示生成专业级 SVG 矢量图形。
  • 多种图像生成模式: 支持单张图像生成、批量图像生成和图像变体生成,满足不同的创作需求。
  • 可配置参数: 提供丰富的参数选项,如分辨率、宽高比、输出格式、风格等,允许用户精细控制生成结果。
  • 历史记录管理: 提供资源浏览功能,方便用户查看和管理过往的图像和 SVG 生成记录。
  • 通用 MCP 兼容性: 兼容所有 MCP 客户端,如 Cursor, Claude Desktop, Cline 和 Zed 等。

安装步骤

  1. 获取 Replicate API Token:

    • 访问 Replicate 注册账号。
    • 在账号设置中创建 API token 并妥善保管。
  2. 安装 Replicate Flux MCP 服务器:

    • 确保您的环境中已安装 Node.js 和 npm。
    • 打开终端,执行以下命令全局安装 'replicate-flux-mcp' 包:
      npm install -g replicate-flux-mcp

服务器配置

MCP 服务器配置用于告知 MCP 客户端如何启动和连接服务器。以下是配置 'replicate-flux-mcp' 服务器的 'mcp.json' 示例,您需要根据您的 MCP 客户端进行配置:

{
  "mcpServers": {
    "replicate-flux-mcp": {  // 服务器名称,可以自定义
      "command": "env REPLICATE_API_TOKEN=YOUR_REPLICATE_API_TOKEN npx", // 启动命令,指定环境变量 REPLICATE_API_TOKEN 和 npx 命令
      "args": ["-y", "replicate-flux-mcp"] // 命令参数,指定运行 replicate-flux-mcp 包
    }
  }
}

配置参数说明:

  • '"replicate-flux-mcp"': 服务器名称,客户端用此名称识别服务器。您可以自定义名称。
  • '"command": "env REPLICATE_API_TOKEN=YOUR_REPLICATE_API_TOKEN npx"': 服务器启动命令。
    • 'env REPLICATE_API_TOKEN=YOUR_REPLICATE_API_TOKEN': 设置环境变量 'REPLICATE_API_TOKEN',请将 'YOUR_REPLICATE_API_TOKEN' 替换为您在 Replicate 官网获取的 API Token。这是服务器连接 Replicate API 的凭证。
    • 'npx': Node.js 包执行器,用于运行本地或全局安装的 npm 包。
  • '"args": ["-y", "replicate-flux-mcp"]': 传递给 'npx' 的参数。
    • '"-y"': 'npx' 参数,用于跳过安装包的确认提示。
    • '"replicate-flux-mcp"': 指定要执行的 npm 包名称,即 'replicate-flux-mcp'。

重要提示:

  • 请务必将 '"YOUR_REPLICATE_API_TOKEN"' 替换为您真实的 Replicate API Token。
  • 不同的 MCP 客户端配置文件的位置和格式可能略有不同,请参考您使用的 MCP 客户端的官方文档进行配置。
  • 如果您不希望全局安装,也可以在项目目录下安装 'replicate-flux-mcp' 并使用相对路径配置启动命令。

基本使用方法

配置完成后,在您的 MCP 客户端(如 Cursor, Claude Desktop 等)中,即可通过自然语言指令调用 Replicate Flux MCP 服务器的功能。

图像生成示例:

向您的 AI 助手发送类似如下指令:

  • '请生成一张日落时分的宁静山景图'
  • '画一幅未来城市夜景的图像'
  • 'generate image of a cute cat wearing a hat' (英文指令)

SVG 矢量图形生成示例:

  • '请生成一个简约风格的房子 SVG 图标'
  • '创建一个科技感十足的电路板 SVG'
  • 'generate svg icon of a shopping cart' (英文指令)

您还可以尝试更高级的功能,例如:

  • 使用 'generate_multiple_images' 工具批量生成多张不同主题的图像。
  • 使用 'generate_image_variants' 工具生成同一主题的不同风格或变体的图像。
  • 使用 'imagelist' 和 'svglist' 资源浏览和查看历史生成记录。

具体工具和资源的使用方法,请参考仓库 README.md 文档中 "Documentation" 章节的详细说明。

信息

分类

AI与计算