图像生成服务器

基于Replicate Flux模型的图像生成MCP服务器,提供文本到图像的转换功能,适用于Claude Desktop等应用场景。

  • by GongRzhe
  • JavaScript
  • 本地部署
  • 51 星标
  • 更新于
在 GitHub 查看 GongRzhe/Image-Generation-MCP-Server

使用说明

图像生成MCP服务器

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

安装

通过Smithery安装

通过以下方式自动安装克劳德桌面的图像生成MCP服务器 史密瑟里:

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

选项1:NPX方法(无需本地设置)

您可以直接从npm使用该包,而无需在本地安装:

# No installation needed - npx will handle it

选项2:本地安装

如果您更喜欢本地安装:

# Global installation
npm install -g @gongrzhe/image-gen-server

# Or local installation
npm install @gongrzhe/image-gen-server

设置

配置Claude桌面

编辑您的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": []
    }
  }
}

获取您的复制API令牌

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

环境变量

  • REPLICATE_API_TOKEN (必需):用于身份验证的Replicate API令牌
  • MODEL (可选):用于图像生成的复制模型。默认为“黑森林实验室/通量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许可证获得许可。