图像生成 MCP 服务器

此 MCP 服务器使用 Replicate Flux 模型提供图像生成功能。

安装

选项 1：NPX 方法（无需本地设置）

您可以直接从 npm 使用该软件包，而无需在本地安装：

# 无需安装 - npx 将处理它

选项 2：本地安装

如果您喜欢本地安装：

# 全局安装
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

选项 1：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": []
    }
  }
}

选项 2：本地安装配置

如果您在本地安装了该软件包：

{
  "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 令牌

1. 在 https://replicate.com 注册/登录
2. 转到 https://replicate.com/account/api-tokens
3. 创建一个新的 API 令牌
4. 复制该令牌并替换 MCP 设置中的 your-replicate-api-token

环境变量

• REPLICATE_API_TOKEN (必需): 您的 Replicate API 令牌，用于身份验证
• MODEL (可选): 用于图像生成的 Replicate 模型。 默认为 "black-forest-labs/flux-schnell"

配置参数

• disabled: 控制服务器是启用 (false) 还是禁用 (true)
• autoApprove: 可以无需用户确认即可执行的工具名称数组。 空数组表示所有工具调用都需要确认。

可用工具

generate_image

使用基于文本提示的 Flux 模型生成图像。

参数

• prompt (必需): 要生成的图像的文本描述
• seed (可选): 用于可重现生成的随机种子
• aspect_ratio (可选): 图像宽高比 (默认: "1:1")
• output_format (可选): 输出格式 - "webp", "jpg", 或 "png" (默认: "webp")
• num_outputs (可选): 要生成的图像数量 (1-4, 默认: 1)

使用示例

const result = await use_mcp_tool({
  server_name: "image-gen",
  tool_name: "generate_image",
  arguments: {
    prompt: "A beautiful sunset over mountains",
    aspect_ratio: "16:9",
    output_format: "png",
    num_outputs: 1
  }
});

该工具返回生成图像的 URL 数组。

📜 许可证

该项目根据 MIT 许可证获得许可。