Image Generation (Flux)

🚀 图像生成 MCP 服务器

此 MCP 服务器借助 Replicate Flux 模型，为用户提供强大的图像生成功能。

🚀 快速开始

本图像生成 MCP 服务器使用 Replicate Flux 模型来实现图像生成功能。下面将详细介绍安装、设置及使用方法。

📦 安装指南

使用 Smithery 进行安装

通过 Smithery 可自动为 Claude Desktop 安装图像生成 MCP 服务器：

npx -y @smithery/cli install @GongRzhe/Image-Generation-MCP-Server --client claude

方法一：NPX（无需本地设置）

直接从 npm 使用包而无需本地安装：

# 无需安装，npx 自行处理

方法二：本地安装

若需要本地安装，可参考以下命令：

# 全局安装
npm install -g @gongrzhe/image-gen-server

# 或者本地安装
npm install @gongrzhe/image-gen-server

🛠️ 设置

配置 Claude Desktop

需编辑你的 Claude Desktop 配置文件：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json%

方法一：NPX 配置（推荐）

此方法直接从 npm 运行服务器，无需本地文件：

{
  "mcpServers": {
    "image-gen": {
      "command": "npx",
      "args": ["@gongrzhe/image-gen-server"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MODEL": "alternative-model-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

方法二：本地安装配置

若你是本地安装，可参考以下配置：

{
  "mcpServers": {
    "image-gen": {
      "command": "node",
      "args": ["/path/to/image-gen-server/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MODEL": "alternative-model-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

获取你的 Replicate API Token

1. 在 https://replicate.com 注册/登录。
2. 前往 https://replicate.com/account/api-tokens。
3. 创建一个新的 API token。
4. 复制该 token 并替换配置中的 your-replicate-api-token。

环境变量

• REPLICATE_API_TOKEN（必填）：用于身份验证的 Replicate API token。
• MODEL（选填）：指定要使用的模型，默认为 "stable-diffusion"。

💻 使用示例

基础用法

generate_image

此工具可生成图像并返回 URL 列表。

参数

{
  "prompt": "输入你的提示词，例如：'一只飞翔的蓝鸟'",
  "negative_prompt": "可选，输入负面提示词",
  "width": 512,
  "height": 512,
  "samples": 1,
  "num_images": 1
}

示例代码

const response = await fetch('http://localhost:4000/api/generate-image', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: "一只飞翔的蓝鸟",
    negative_prompt: "",
    width: 512,
    height: 512,
    samples: 1,
    num_images: 1
  })
});

const data = await response.json();
console.log(data.urls); // 输出 URL 列表

📄 许可证

此项目遵循 MIT License。