使用说明

项目简介

Replicate FLUX MCP服务器是一个基于 Model Context Protocol (MCP) 的后端实现,它通过 MCP 协议向 LLM 客户端提供图像生成能力。该服务器集成 Replicate 平台的 FLUX 模型,允许用户通过发送文本提示词,远程调用模型生成图像,并将生成的图像保存到服务器本地。

主要功能点

  • 图像生成工具: 提供 'generate-image' 工具,接收文本提示词和文件名,调用 Replicate FLUX 模型生成图像。
  • 本地保存: 生成的图像将保存到服务器本地的 'output' 目录下。
  • MCP 协议支持: 遵循 MCP 协议,可以通过标准的 MCP 客户端进行连接和调用。
  • Stdio 传输: 使用 Stdio 作为 MCP 服务器的传输协议,方便本地部署和运行。

安装步骤

  1. 克隆仓库: 将 GitHub 仓库 'https://github.com/ozgrozer/mcp-replicate-flux' 克隆到本地。
    git clone https://github.com/ozgrozer/mcp-replicate-flux
    cd mcp-replicate-flux
  2. 安装依赖: 使用 npm 安装项目依赖。
    npm install
  3. 配置环境变量:
    • 在项目根目录下创建 '.env' 文件。
    • 从 Replicate 官网获取 API Token,并将其添加到 '.env' 文件中,例如:
      REPLICATE_API_TOKEN=your_replicate_api_token
      请务必替换 'your_replicate_api_token' 为你自己的 Replicate API Token。

服务器配置

MCP 客户端需要配置以下 JSON 信息才能连接到 Replicate FLUX MCP 服务器。

{
  "serverName": "Replicate-FLUX-MCP-Server",
  "command": "node",
  "args": ["index.js"]
}

配置参数说明:

  • serverName: MCP 服务器的名称,可以自定义,例如 "Replicate-FLUX-MCP-Server"。
  • command: 启动 MCP 服务器的命令,这里使用 'node' 命令来运行 JavaScript 代码。
  • args: 传递给启动命令的参数,这里指定了入口文件 'index.js',表示运行 'index.js' 文件来启动服务器。

MCP 客户端需要根据自身配置界面的要求,填入以上 JSON 配置信息。 通常在 MCP 客户端中,你需要找到 "添加服务器" 或 "连接服务器" 相关的选项,并将上述 JSON 配置粘贴或填写到相应的配置项中。

基本使用方法

  1. 启动服务器: 在项目根目录下,通过以下命令启动 MCP 服务器。

    npm start

    或者直接运行 'node index.js'

    node index.js

    服务器成功启动后,会监听 Stdio 输入输出,等待 MCP 客户端的连接和请求。

  2. 使用 MCP 客户端连接服务器: 配置好上述服务器配置信息后,在 MCP 客户端中连接到该服务器。

  3. 调用 'generate-image' 工具: 在 MCP 客户端中,可以使用 'generate-image' 工具来生成图像。调用该工具时,需要提供以下参数:

    • prompt: 文本提示词,用于描述想要生成的图像内容。
    • filename: 生成图像的文件名,例如 'my_image.jpg'。

    MCP 客户端会将请求发送到 Replicate FLUX MCP 服务器,服务器会调用 Replicate FLUX 模型生成图像,并将图像保存到服务器本地的 'output' 目录下。 MCP 客户端会收到工具执行成功的消息,其中包含图像保存路径的信息。

注意:

  • 确保已安装 Node.js 和 npm。
  • 确保已配置正确的 Replicate API Token。
  • 首次运行前请先安装项目依赖。
  • MCP 客户端的具体使用方式请参考 MCP 客户端的文档。

信息

分类

AI与计算