使用说明

项目简介

Replicate图像生成MCP服务器是一个实现了Model Context Protocol (MCP) 的后端服务，它利用Replicate平台的模型为LLM客户端提供图像生成能力。通过此服务器，LLM客户端可以调用预定义的工具，根据文本描述生成图像。

主要功能点

图像生成工具: 提供 'generate_image' 工具，允许LLM客户端通过文本prompt生成图像。
Replicate模型集成: 使用Replicate平台提供的图像生成模型，支持灵活的模型配置。
标准化MCP协议: 遵循MCP协议标准，易于与各种MCP客户端集成，例如Claude Desktop。
灵活部署: 支持NPX快速启动和本地安装两种部署方式。

安装步骤

你可以选择以下两种方式安装和运行此MCP服务器：

方式一：NPX 方式 (推荐，无需本地安装)

此方式无需本地安装软件包，直接通过 'npx' 命令运行。

确保你的环境中已安装 Node.js 和 npm。
无需额外安装步骤，直接配置客户端并运行即可。

方式二：本地安装

如果你希望本地安装软件包，可以执行以下命令：

确保你的环境中已安装 Node.js 和 npm。

全局安装 (推荐):

npm install -g @gongrzhe/image-gen-server

或者本地安装:

npm install @gongrzhe/image-gen-server

服务器配置

要将此MCP服务器与MCP客户端（如Claude Desktop）连接，你需要配置客户端的MCP服务器设置。以下是针对不同安装方式的配置示例。请注意，你需要将 'your-replicate-api-token' 替换为你自己的 Replicate API Token。

Claude Desktop 配置示例 (编辑 'claude_desktop_config.json' 文件)

方式一：NPX 方式配置 (推荐)

{
  "mcpServers": {
    "image-gen": {
      "command": "npx",
      "args": ["@gongrzhe/image-gen-server"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token"
        // "MODEL": "alternative-model-name" // 可选：指定Replicate模型，默认为 "black-forest-labs/flux-schnell"
      },
      "disabled": false, // 设置为 true 禁用该服务器，设置为 false 启用
      "autoApprove": []   // 自动批准的工具列表，空数组表示所有工具调用都需要用户确认
    }
  }
}

方式二：本地安装方式配置

请根据你的本地安装路径调整 'args' 中的路径。

{
  "mcpServers": {
    "image-gen": {
      "command": "node",
      "args": ["/path/to/image-gen-server/build/index.js"], // 替换为你的实际安装路径，例如 /usr/local/lib/node_modules/@gongrzhe/image-gen-server/build/index.js
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token"
        // "MODEL": "alternative-model-name" // 可选：指定Replicate模型，默认为 "black-forest-labs/flux-schnell"
      },
      "disabled": false, // 设置为 true 禁用该服务器，设置为 false 启用
      "autoApprove": []   // 自动批准的工具列表，空数组表示所有工具调用都需要用户确认
    }
  }
}

获取 Replicate API Token

访问 Replicate官网并注册/登录。
前往 API Tokens页面。
创建新的 API token 并复制。
将复制的 Token 粘贴到上述配置的 'REPLICATE_API_TOKEN' 环境变量中。

基本使用方法

配置完成后，在支持MCP协议的LLM客户端中，你可以通过 'image-gen' 服务器调用 'generate_image' 工具来生成图像。

例如，在Claude Desktop中，你可以指示Claude使用 'image-gen' 服务器的 'generate_image' 工具，并提供图像描述prompt。服务器会将生成的图像URL返回给客户端。

工具调用示例:

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

工具将返回一个包含生成图像URL的数组。

关键词