STARWARCLOUD STARWAR.AI
返回市场
麦普复制流

麦普复制流

作者：andylee2001410 星标更新：2025-04-13
安装使用来源：spider==github.com

项目介绍

技术文档摘要

MCP Replicate FLUX

smithery 徽章

这是一个使用Replicate的FLUX模型生成图像，并将它们存储在Cloudflare R2中的Model Context Protocol (MCP)服务器。

使用Replicate的FLUX模型生成图像，并将它们存储在Model Context Protocol (MCP)服务器上的Cloudflare R2中。

特性

  • 使用Replicate的black-forest-labs/flux-schnell模型生成图像
  • 将生成的图像存储在Cloudflare R2中
  • 返回可访问的图像URL
  • 支持自定义提示词和文件名
  • 使用Replicate的black rest labs/flex schnell模型生成图像
  • 将生成的图像存储到Cloudflare R2中
  • 返回可访问的图像链接
  • 支持自定义提示词和文件名

前提条件

  • Node.js（v16或更高版本）
  • Replicate API令牌
  • Cloudflare R2存储桶和凭证
  • npm或yarn
  • Node.js（v16或更高版本）
  • 克隆API令牌
  • Cloudflare R2 存储桶和凭证
  • npm 或 yarn

环境变量

.env 文件中需要的环境变量：

REPLICATE_API_TOKEN=your_replicate_token
STORAGE_ENDPOINT=your_r2_endpoint
STORAGE_ACCESS_KEY=your_r2_access_key
STORAGE_SECRET_KEY=your_r2_secret_key
STORAGE_BUCKET=your_bucket_name
STORAGE_DOMAIN=your_domain

本地安装

通过Smithery安装

要通过Smithery自动安装MCP Replicate FLUX for Claude Desktop：

npx -y @smithery/cli install @andylee20014/mcp-replicate-flux --client claude

手动安装

按照以下步骤在本地设置项目：

# 克隆仓库
git clone https://github.com/andylee20014/mcp-replicate-flux.git
cd mcp-replicate-flux

# 安装依赖
npm install

# 创建 .env 文件并添加您的凭证
cp .env.example .env
# 使用实际凭证编辑 .env

确保您的Cloudflare R2存储桶具有适当的CORS设置，以便公众可以访问上传的图像。

确保您的Cloudflare R2存储桶具有适当的CORS设置，以允许公众访问上传的图像。

在本地运行

要启动本地的MCP服务器：

node index.js

服务器将启动并通过标准输入/输出监听MCP协议消息。

使用方法

服务器提供了一个接受两个参数的generate-image工具：

  • prompt：用于生成图像的文本提示
  • filename：生成图像所需的文件名

服务器提供了一个接受两个参数的generate-image工具：

  • prompt：用于生成图像的文本提示词
  • filename：生成图像所需的文件名

集成示例

这里是一个如何使用MCP客户端库与这个MCP服务器集成的例子：

const { McpClient } = require('@modelcontextprotocol/sdk/client/mcp.js')

async function generateImage(prompt, filename) {
  const client = new McpClient()
  // 连接到正在运行的MCP服务器
  await client.connect(yourTransport)
  
  const result = await client.tools.call('generate-image', {
    prompt,
    filename
  })
  
  return result
}

示例响应：

{
  "content": [
    { "type": "text", "text": "图像成功生成并上传到Cloudflare R2" },
    { "type": "image", "url": "https://your-domain.com/filename.jpg" }
  ]
}

测试

提供了一个测试脚本来验证图像生成和上传功能。

运行测试

node test.js

测试脚本将：

  1. 使用示例提示词生成图像
  2. 将图像上传到Cloudflare R2
  3. 返回可访问的URL

示例测试输出：

使用提示词“一个美丽的女孩”生成图像
文件名：test-1234567890.jpg
图像生成并上传成功！
图像URL：https://your-domain.com/test-1234567890.jpg

您可以修改test.js中的提示词来测试不同的图像生成场景。

Cursor MCP配置

在Cursor中有两种方式来配置MCP服务器：

方法1：完整配置

在~/.cursor/mcp.json创建包含所有环境变量的完整配置文件：

{
  "mcpServers": {
    "replicate-flux": {
      "command": "node",
      "args": ["C:\\Users\\YourUsername\\path\\to\\mcp-replicate-flux\\index.js"],
      "description": "使用Replicate的FLUX模型生成图片并存储到Cloudflare R2的MCP服务器",
      "env": {
        "REPLICATE_API_TOKEN": "your_replicate_token",
        "STORAGE_ENDPOINT": "your_r2_endpoint",
        "STORAGE_ACCESS_KEY": "your_r2_access_key",
        "STORAGE_SECRET_KEY": "your_r2_secret_key",
        "STORAGE_BUCKET": "your_bucket_name",
        "STORAGE_DOMAIN": "your_domain"
      }
    }
  }
}

方法2：最小配置

如果您希望单独管理环境变量（使用系统环境变量或.env文件），可以使用最小配置：

{
  "mcpServers": {
    "replicate-flux": {
      "command": "node",
      "args": ["C:\\Users\\YourUsername\\path\\to\\mcp-replicate-flux\\index.js"]
    }
  }
}

当使用最小配置时，请确保您的环境变量正确设置在以下位置之一：

  • 系统环境变量
  • 项目目录中的.env文件
  • 部署服务器的云平台环境变量

注意事项

  • description字段在两种方法中都是可选的
  • 配置文件中的环境变量优先级高于系统环境变量
  • 更改配置后，重启Cursor以应用更改

项目结构

mcp-replicate-flux/
├── .env                  # 环境变量
├── index.js             # MCP服务器入口点
├── generateImage.js      # 图像生成和R2上传逻辑
├── test.js              # 测试脚本
└── README.md            # 项目文档

故障排除

常见问题

  1. 图像生成失败：检查您的Replicate API令牌和配额
  2. R2上传失败：验证您的R2凭证和存储桶权限
  3. 无法访问生成的图像：确保您的R2存储桶具有正确的CORS配置

MCP协议描述

Model Context Protocol (MCP)是一种AI模型交互标准，使不同AI系统之间能够互操作。此服务器实现了一个MCP工具，可以与任何兼容MCP的客户端一起使用。

对于更多关于MCP的信息，请访问：https://mcp.freeaigen.com/

参考链接

许可证

MIT