Flux Image MCP Server

🚀 使用Flux Schnell模型通过Replicate生成图像的Flux Image MCP服务器

本MCP服务器借助Flux Schnell模型，在Replicate平台上实现图像生成功能，为用户提供便捷的图像生成服务。

🚀 快速开始

此MCP服务器利用Flux Schnell模型在Replicate上提供图像生成功能。接下来为您详细介绍使用步骤。

📦 安装指南

全局安装MCP SDK

npm install -g @modelcontextprotocol/sdk@latest

克隆仓库

将此仓库克隆到您的MCP服务器目录中：

cd ~/Documents/Cline/MCP
git clone https://github.com/yourusername/flux-img-mcp.git
cd flux-img-mcp
npm install

构建服务器

npm run build

配置服务器

将服务器配置添加到您的MCP设置文件（全局或工作区）中：

{
  "mcpServers": {
    "flux-img": {
      "command": "node",
      "args": ["/path/to/flux-img-mcp/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

🔧 配置要求

服务器需要以下环境变量：

• REPLICATE_API_TOKEN：您的Replicate API令牌。可以从Replicate账户设置获取。

💻 使用示例

基础用法

安装完成后，您可以配置如下工具进行图像生成：

generate_image

根据文本提示生成图像，使用Flux Schnell模型。 参数：

• prompt (string, 必填)：描述所需图像的文本

示例用法：

<use_mcp_tool>
<server_name>flux-img</server_name>
<tool_name>generate_image</tool_name>
<arguments>
{
  "prompt": "A beautiful sunset over mountains"
}
</arguments>
</use_mcp_tool>

工具将返回包含以下内容的JSON响应：

• status：生成请求的状态
• output：生成图像的URL（如果成功）
• error：任何错误信息（如果失败）

📚 详细文档

开发指南

若您需要对服务器进行修改，可以按照以下步骤操作：

1. 修改源代码在 src/index.ts
2. 重建服务器：npm run build
3. 重启MCP服务器以应用更改

错误处理

服务器包含全面的错误处理功能，涵盖以下情况：

• 缺少API令牌
• 参数无效
• API请求失败
• 网络问题

安全注意事项

• 切勿将Replicate API令牌提交到版本控制系统
• 始终通过环境变量提供令牌
• 服务器会对所有输入参数进行验证，确保安全