项目简介

Replicate Imagen 4 智能图像生成服务是一个基于 Model Context Protocol (MCP) 的服务器端应用。它集成了 Google 最新的 Imagen 4 Ultra 图像生成模型（通过 Replicate 平台），为您的LLM客户端（如Claude Desktop, Kilo Code等）提供强大的图像生成能力。此服务支持多种图像比例、格式和安全过滤级别，并能自动将生成的图像下载到本地，方便管理和使用。

主要功能点

高质量图像生成: 利用 Google Imagen 4 Ultra 模型，生成细节丰富、光影真实的高质量图像。
自动本地下载: 所有生成的图像会自动下载到本地 'images' 文件夹，并采用智能命名规则。
多种图像配置: 支持 1:1, 16:9, 9:16, 3:4, 4:3 等多种图片宽高比，并可选择 JPG 或 PNG 格式。
内容安全过滤: 提供多级别的内容安全过滤选项（如 'block_low_and_above', 'block_medium_and_above', 'block_only_high'），确保生成内容符合要求。
预测状态追踪: 可查询 Replicate 平台上特定图像生成任务（Prediction ID）的执行状态和结果。
双重访问: 返回本地文件路径和原始图像URL，提供灵活的访问方式。
稳定可靠: 具备鲁棒的错误处理机制，应对 API 错误和网络问题。

安装步骤

获取 Replicate API 令牌:
- 访问 Replicate 官网并注册账号。
- 登录后，前往您的账户设置页面，生成一个 API 令牌。

配置 MCP 客户端（推荐使用 npx 方式）:

这是最简单、最便携的方式，无需本地安装。在您的 MCP 客户端配置中，找到或创建 'mcpServers' 部分，并添加以下 JSON 片段，将 '"您的Replicate API令牌"' 替换为您的真实令牌：

{
  "mcpServers": {
    "replicate-imagen4": {
      "command": "npx",
      "args": ["-y", "https://github.com/PierrunoYT/replicate-imagen4-mcp-server.git"],
      "env": {
        "REPLICATE_API_TOKEN": "您的Replicate API令牌"
      }
    }
  }
}

本地安装（可选，适用于开发或偏好本地部署的用户）:

确保您的系统已安装 Node.js 18 或更高版本。

打开终端，执行以下命令克隆仓库并安装依赖：

git clone https://github.com/PierrunoYT/replicate-imagen4-mcp-server.git
cd replicate-imagen4-mcp-server
npm install
npm run build

安装完成后，您可以使用 'npm run get-path' 命令来获取详细的 MCP 客户端配置路径。

服务器配置

此 MCP 服务器需要配置在您的 MCP 客户端（如 Claude Desktop 或 Kilo Code）中，以便客户端能发现并调用其提供的功能。以下是配置示例，请根据您的实际安装方式选择：

对于使用 'npx' 方式的便携安装：

在您的 MCP 客户端的配置中，找到或创建 'mcpServers' 部分，并添加以下条目：

{
  "mcpServers": {
    "replicate-imagen4": {
      "command": "npx",
      "args": ["-y", "https://github.com/PierrunoYT/replicate-imagen4-mcp-server.git"],
      "env": {
        "REPLICATE_API_TOKEN": "您的Replicate API令牌" // 请替换为您的真实 Replicate API 令牌
      },
      "disabled": false, // 设置为 false 表示启用此服务器
      "alwaysAllow": [] // 始终允许调用的工具列表，为空表示 MCP 客户端会按需提示用户授权
    }
  }
}

对于本地安装的配置：

首先，运行 'npm run get-path' 命令获取服务器的绝对路径。例如，它可能会输出 '/path/to/replicate-imagen4-mcp-server/build/index.js'。然后，在您的 MCP 客户端配置中添加：

{
  "mcpServers": {
    "replicate-imagen4": {
      "command": "node",
      "args": ["您的服务器绝对路径"], // 请替换为 npm run get-path 命令输出的服务器绝对路径
      "env": {
        "REPLICATE_API_TOKEN": "您的Replicate API令牌" // 请替换为您的真实 Replicate API 令牌
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

配置完成后，请务必重启您的 MCP 客户端以加载新的服务器。

基本使用方法

在您的 MCP 客户端中，LLM 可以通过调用以下工具来生成图像：

'imagen4_generate' (生成图像):

用途: 根据文本描述生成图像，并自动下载到本地 'images' 目录。
参数:
- 'prompt' (必填): 图像的文本描述。
- 'aspect_ratio' (可选): 图像的宽高比，可选值为 "1:1", "9:16", "16:9", "3:4", "4:3" (默认 "1:1")。
- 'safety_filter_level' (可选): 内容安全过滤级别，可选值为 "block_low_and_above", "block_medium_and_above", "block_only_high" (默认 "block_only_high")。
- 'output_format' (可选): 输出图像的格式，可选值为 "jpg", "png" (默认 "jpg")。

LLM 示例指令:

生成一张图片：
- 描述: "一只金毛寻回犬在向日葵田里玩耍的超现实照片"
- 宽高比: "16:9"
- 输出格式: "png"
- 安全级别: "block_medium_and_above"

或者简单地：

生成一张“一只可爱的猫咪在键盘上睡觉”的图片。

'imagen4_generate_and_save' (生成并保存图像):
- 用途: 与 'imagen4_generate' 类似，但可以指定一个自定义的本地文件名来保存图像。
- 参数:
  - 'prompt' (必填): 图像的文本描述。
  - 'filename' (可选): 保存图像的自定义文件名（例如 'my_image.jpg'）。如果未提供，将自动生成文件名。
  - 'aspect_ratio' (可选): 同 'imagen4_generate'。
  - 'safety_filter_level' (可选): 同 'imagen4_generate'。
  - 'output_format' (可选): 同 'imagen4_generate'。
- LLM 示例指令:
```
生成并保存一张图片：
- 描述: "未来主义的城市夜景，霓虹灯和飞行的汽车"
- 文件名: "未来城市.jpg"
- 宽高比: "16:9"
```
'imagen4_get_prediction' (查询预测状态):
- 用途: 查询 Replicate 平台上特定图像生成任务的执行状态和结果。当 LLM 需要查询之前任务时使用。
- 参数:
  - 'prediction_id' (必填): Replicate 预测任务的 ID。
- LLM 示例指令:
```
查询 ID 为 "dp123456789" 的图片生成任务状态。
```
  （'dp123456789' 是一个示例预测ID，通常由 'imagen4_generate' 或 'imagen4_generate_and_save' 任务返回。）

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息