Flux Image MCP 服务器

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

安装

0. 全局安装 MCP SDK：

npm install -g @modelcontextprotocol/sdk@latest

1. 将此存储库克隆到您的 MCP 服务器目录：

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

2. 构建服务器：

npm run build

3. 将服务器配置添加到您的 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 (字符串，必需): 所需图像的文本描述

用法示例：

<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 令牌提交到版本控制
• 始终通过环境变量提供令牌
• 服务器在发出 API 请求之前验证所有输入参数